References¶
Webhook Registration¶
In order to complete the webhook registration, you need to send us your endpoint configuration by calling:
POST /v1/supplier/registration/config
Note
You will be given Booking.com OAuth credentials to access the endpoint. Follow the steps in the Getting Started section on how to use the credentials.
Request¶
| Field | Type | Description | Required |
|---|---|---|---|
| endpoint | String | Base URL of the webhook endpoint | Yes |
| authenticationType | String | Type of authentication for the webhook endpoint. Options are: OAUTH |
Yes |
| secret | String | Secret to be used based on type of authentication. Minimum length is 8 characters | Yes |
| clientId | String | Client Id to be used along with the secret | Yes - but only when authentication type is OAUTH |
Sample Request¶
{
"endpoint": "https://www.test.com/",
"authenticationType": "OAUTH",
"secret": "test-secret",
"clientId": "test-clientid"
}
Response¶
HTTP 204 - No Content¶
HTTP 400 - Bad Request¶
{
"errorCode": "6f165af4-56e1-493f-a651-145c65fa4ed7",
"errorMessage": "Client ID is required when authentication type is OAUTH"
}
Webhook Deletion¶
DELETE /v1/supplier/registration/config
Note
Using this endpoint stops new search requests and booking capabilities. Existing bookings remain unaffected.
Response¶
HTTP 204 - No Content¶
HTTP 404 - Not Found¶
{
"errorCode": "2da334fa-fbc4-7192-8f5e-79286f115810",
"errorMessage": "Secret configuration not found"
}