Webhooks
Inbound webhook endpoints for real-time integration events.
Basirah receives inbound webhooks from connected external systems to enable real-time bidirectional sync.
/api/v1/webhooks/{provider} Receive webhook events from external providers (Jira, ServiceNow, etc.). The provider path segment identifies which integration handles the payload.
How webhooks work
When a connected ticketing system sends a webhook (e.g., a Jira issue status change), Basirah routes the payload to the correct integration based on the provider identifier and the webhook’s integration reference. The payload is validated, and the corresponding work item is updated.
Webhook endpoints don’t require standard API authentication — they use provider-specific verification mechanisms configured during integration setup.
Webhook payload formats are provider-specific. Refer to /api/v1/openapi.json on your Basirah
instance for supported providers and payload expectations.