# Register to Webhook Events API

The Webhook APIs is a REST API designed to manage webhooks for booking notifications. It allows partners to register, update, and delete webhook endpoints, enabling them  to receive real-time booking event updates.


Version: 1.1.0

## Servers

Staging
```
https://api-staging.bookabletech.com
```

Production
```
https://api.bookabletech.com
```

## Security

### Staging

This API uses OAuth2 client credentials flow via Auth0.
**Important:** Include the `audience` parameter in your token request.
Example token request:
```
POST https://bookabletech.uk.auth0.com/oauth/token
{
  "grant_type": "client_credentials",
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET",
  "audience": "api.bookabletech.com"
}
```


Type: oauth2

### Production

This API uses OAuth2 client credentials flow via Auth0.
**Important:** Include the `audience` parameter in your token request.
Example token request:
```
POST https://auth.bookabletech.com/oauth/token
{
  "grant_type": "client_credentials",
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET",
  "audience": "api.bookabletech.com"
}
```


Type: oauth2

## Download OpenAPI description

[Register to Webhook Events API](https://docs.bookabletech.com/_bundle/apis/production/webhook/WebhookApi.yaml)

## webhook

Operations related to webhook management

### Register a webhook endpoint for booking notifications

 - [POST /webhooks](https://docs.bookabletech.com/apis/production/webhook/webhookapi/webhook/registerwebhook.md)

### Update the webhook callback URL of the specific distributor logged

 - [PUT /webhooks](https://docs.bookabletech.com/apis/production/webhook/webhookapi/webhook/updatewebhook.md)

### Delete the webhook for a specific distributor

 - [DELETE /webhooks](https://docs.bookabletech.com/apis/production/webhook/webhookapi/webhook/deletewebhook.md)

### Trigger a test webhook event

 - [POST /webhooks/test](https://docs.bookabletech.com/apis/production/webhook/webhookapi/webhook/triggertestwebhook.md): Sends a test webhook notification to the registered callback URL. This endpoint is useful for testing webhook integration and verifying that the partner's endpoint can receive and process webhook events correctly.