Knowledge Base
Webhooks API
Webhooks API
The Webhooks API enables you to receive real-time notifications about events happening within the Narrative Data Collaboration Platform. By creating webhook subscriptions, you can receive HTTP POST requests to your specified endpoints whenever relevant events occur, such as job state changes.
For complete OpenAPI documentation, visit: https://docs.narrative.io/open-api#tag/Webhooks
Overview
What are Webhooks?
Webhooks allow your applications to receive real-time notifications when specific events occur in the Narrative platform. Instead of polling for updates, your application receives an immediate HTTP POST request containing event data.
Key Features:
- Real-time event notifications
- Job state monitoring (pending, running, completed, failed)
Webhook Types
Job State Webhooks
Monitor the lifecycle of jobs within the Narrative platform - from data processing and forecasting to model training and dataset operations.
Job Types Reference
See all available job types with detailed descriptions, triggers, and monitoring strategies.