Skip to main content
All CollectionsAppsWebhooks and API integration
V2 Webhooks for Reservations
V2 Webhooks for Reservations

Webhooks are a way to receive data from Hospitable in real-time whenever a triggering event happens, such as reservation changes.

Frances Rebollido avatar
Written by Frances Rebollido
Updated over 2 weeks ago

Webhooks are a way to receive reservation data to your server whenever a reservation is created and changed.

We now have v2 webhooks available which has more triggers and provides more data points than our legacy (v1) webhooks.

Setting up a webhook

  1. Go to Apps

  2. Click on Webhooks under Tools.

  3. With the first tab (Webhooks) selected, click on +Add new.

  4. Give it a name and provide the URL where the webhook will be sent.

  5. Click Save.

  6. Clicking Test will send your latest reservation to the url configured.

Webhook triggers

We currently only support webhooks for Reservations and a webhook is sent whenever these events occur:

Reservation creation

These webhooks will have an action of reservation.created and will be sent when a new reservation is created.

Reservation changed

These webhooks will have an action of reservation.changed and will be sent when any of the following occur:

  • Status changes:

    • Pending

    • Accepted

    • Not accepted

    • Cancelled

  • Changed to another listing

  • Changes to the check-in or check-out date

  • Changes to the check-in or check-out time

  • Changes to the number of guests

  • Changes to the number of night

Retries

We will always send POST requests to this URL and expect a 200 OK response status code from your webhook handler. Other responses or lack thereof will cause webhook re-tries. We will retry it up to 5 times or until successful response, with exponential back-off: 1 sec, 5 sec, 10 sec, 1 hr, 6 hr.

IP Range

The webhooks are sent from IP addresses within the 38.80.170.0/24 range. This means you can expect requests from addresses between 38.80.170.0 and 38.80.170.24..

You are advised to whitelist only this IP for your webhook handler for better security.

Historic webhooks

It is not possible to resend webhooks generated in a specific period of time. You can only have all webhooks resent by clicking on the 3 dots icon and selecting Send historic webhooks. Only reservations with 'Accepted' as the last status are sent.

Webhook data

All webhooks are sent as JSON with the request having a Content-Type of application/json

To see a list of data fields and possible values in a webhook along with an example payload, visit our technical documentation.

Did this answer your question?