Webhook management
Webhooks allow Batida to integrate with external systems by sending or receiving HTTP requests. Batida supports both inbound webhooks (receiving events from external systems) and outbound webhooks (sending Batida events to external endpoints).
Inbound webhooks
Batida receives external events through the Alert Webhooks endpoint. Monitoring tools like Datadog and Grafana send alerts to:
POST /api/v1/webhooks/alerts
Authorization: Bearer <token>See Alert Webhooks for full setup instructions, supported sources, and field mappings.
Outbound webhooks
Outbound webhooks send Batida events to external systems when specific actions occur.
Creating an outbound webhook
- Navigate to Settings > Webhooks.
- Click Create Outbound Webhook.
- Enter a name, target URL, and the events you want to subscribe to.
- Configure retry settings.
- Save the webhook.
Supported events
| Event | Description |
|---|---|
| incidents.opened | A new incident was created |
| incidents.status_changed | An incident's status was updated |
| incidents.resolved | An incident was resolved |
Payload format
Outbound webhooks send a JSON payload with event details:
{
"event": "incidents.opened",
"timestamp": "2026-04-20T14:30:00Z",
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"title": "Payment gateway returning 500 errors",
"severity": "SEV2",
"status": "investigating"
}
}Delivery logs
Every webhook delivery is logged. View delivery logs to see:
- Whether the delivery succeeded or failed.
- The HTTP status code returned by the target.
- The request payload and response body.
- Timestamp of each delivery attempt.
Retry policy
Failed outbound webhook deliveries are retried automatically:
| Attempt | Delay |
|---|---|
| 1st | Immediate |
| 2nd | 1 minute |
| 3rd | 5 minutes |
| 4th | 30 minutes |
| 5th | 2 hours |
If all retries fail, the delivery is marked as failed and logged. You can manually retry from the delivery log.
TIP
Always verify webhook signatures on the receiving end to ensure the payload is authentic. See the API documentation for signature verification details.