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".

post
/api/webhooks

https://datelist.io/api/webhooks
This endpoint allows you to subscribe to a webhook, to receive the new booking notification.
Request
Response
Request
Headers
Authentication
required
string
Authentication token (see the authentication section)
Body Parameters
url
optional
string
The URL where we should POST information about new bookings.
calendar_id
optional
integer
The ID of the calendar you would like to watch (see the #calendar endpoint)
Response
200: OK
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",
}