Webhooks

To retrieve the bookings of one of your Datelist calendars, you must tell our application to send you all the new booking events, by "subscribing to a webhook".

/api/webhooks

POST https://datelist.io/api/webhooks

This endpoint allows you to subscribe to a webhook, to receive the new booking notification.

Headers

Name	Type	Description
Authentication	string	Authentication token (see the authentication section)

Request Body

Name	Type	Description
url	string	The URL where we should POST information about new bookings.
calendar_id	integer	The ID of the calendar you would like to watch (see the #calendar endpoint)

200 Webhook successfully created

{
  "id": 1234,
  "calendar_id": 12,
  "user_id": 23,
  "url": "https://datelist.io/webhooks/12345",
  "created_at": "2021-06-15T12:31:25.652Z",
  "updated_at": "2021-06-15T12:31:25.652Z",
}