Difference between revisions of "Inventory Webhooks"

From Beds24 Wiki
Jump to navigation Jump to search
 
(25 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Web Hooks ==
+
[[Category:Webhooks]]
 +
<div class="heading">Inventory Webhooks</div>
  
Send a web hook to your service whenever a room type needs syncing.
+
This page is about the menu  {{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > WEBHOOKS
  
Enter the public facing URL to recieve the request.
+
 
 +
Send a web hook request to your service whenever a room type needs syncing because an availability or price has changed.
 +
 
 +
Enter the public facing URL to receive the request.
 +
 
 +
Optional headers can be specified for authentication or other purposes if required.
 +
 
 +
The web hook request expects an HTTP response code between 200 and 299, if it does not see this it will be retried a number of times over the next 30 minutes before giving up.
  
 
Web hooks are triggered by new bookings, modification to booked dates, cancellations, an inventory change or a price change on a room type.
 
Web hooks are triggered by new bookings, modification to booked dates, cancellations, an inventory change or a price change on a room type.
Line 10: Line 18:
  
  
The web hook request payload contains json data in the body with the roomid which triggered the request.
+
The web hook request payload contains json data in it's body with the roomId which triggered the request.
  
 
This can be used to keep external services synchronised with minimum delay whenever changes occur.
 
This can be used to keep external services synchronised with minimum delay whenever changes occur.
  
The web hook request expects an http 200 response code, if it does not see this it will be retried a number of times over the next 30 minutes.
 
  
Optional headers can be specified for authentication or other purposes if required.
+
Typical JSON data posted by the web hook request:
 +
 
 +
<code>{"roomId":"123456","propId":"12345","ownerId":"1234","action":"SYNC_ROOM"}</code>
 +
 
 +
 
 +
You can add your own data in the "Custom Header" field if required including using template variables. The data will be sent as HTTP headers to the remote server with the webhook.
 +
 
 +
 
 +
<div class="warning">{{#fas:exclamation-triangle}} You can NOT use [https://wiki.beds24.com/index.php?title=Template_Variables Template variables] here as this webhook operates on a room level. [https://wiki.beds24.com/index.php?title=Template_Variables Template variables] are only available in the context of a booking.</div>

Latest revision as of 10:57, 29 October 2024

Inventory Webhooks
This page is about the menu   (SETTINGS) APPS & INTEGRATIONS > WEBHOOKS


Send a web hook request to your service whenever a room type needs syncing because an availability or price has changed.

Enter the public facing URL to receive the request.

Optional headers can be specified for authentication or other purposes if required.

The web hook request expects an HTTP response code between 200 and 299, if it does not see this it will be retried a number of times over the next 30 minutes before giving up.

Web hooks are triggered by new bookings, modification to booked dates, cancellations, an inventory change or a price change on a room type.

Changes to restrictions like minimum stay do not trigger a web hook.


The web hook request payload contains json data in it's body with the roomId which triggered the request.

This can be used to keep external services synchronised with minimum delay whenever changes occur.


Typical JSON data posted by the web hook request:

{"roomId":"123456","propId":"12345","ownerId":"1234","action":"SYNC_ROOM"}


You can add your own data in the "Custom Header" field if required including using template variables. The data will be sent as HTTP headers to the remote server with the webhook.


You can NOT use Template variables here as this webhook operates on a room level. Template variables are only available in the context of a booking.