Skip to content

Incident Webhook

What does it do?

The incident webhooks notify you when a new incident is created or an existing incident is updated in Booking.com's systems.

Why use it?

Receive real-time incident notifications to update your systems immediately, rather than relying solely on polling the GET /v1/incidents endpoint.

How does it work?

  1. Self-enrol for the INCIDENT webhook
  2. Implement POST /v2/incidents to receive new incident notifications
  3. Implement PATCH /v2/incidents to receive updates to existing incidents

Your API must be served via HTTPS with a valid SSL certificate and secured using OAuth 2.0 authentication.

No retry logic

The incident webhook has no retry logic. If your server is unavailable or returns an error, the notification will not be resent. Continue polling GET /v1/incidents as a backup.

Further reading