Incident Webhook¶

What does it do?¶

These webhooks allow suppliers to be notified about a new incident or receive updates to an existing incident as they are received and stored in Booking.com systems in real time.

Why use it?¶

If you would like to be notified about a new incident or updates to an existing incident then you can implement these webhooks. You can then use the information provided by the webhooks to update your systems as necessary.

How does it work?¶

As with other webhooks, suppliers would need to implement OAuth authentication and complete onboarding with Booking.com to be able to receive incident data via these webhooks. More information on Authentication can be found here.

Booking.com Taxi will send you a request when a new incident is created or when an existing incident is updated. The payload will contain all the information regarding the incident. You do not need to respond to the webhooks.

It’s important to note that webhooks are considered “fire & forget” therefore we do not guarantee delivery of the payloads. You shouldn’t rely solely on the incident webhooks to be informed of new incidents or changes to incidents, you should also make use of our “/v1/incidents” endpoint.

Your API should be served via HTTPS with a valid SSL certificate.