Overview
The Webhook section allows you to configure endpoints for real-time communication between your system and Bakuun in the live environment that enable real-time communication.
By setting up Mapping, ARI, and Booking endpoints, your system can automatically send and receive updates for mapping, availability, rates, inventory, and bookings.
Webhook → Mapping Endpoints
The Mapping endpoints section allows you to configure how mapping data is exchanged between your system and Bakuun.
These endpoints support both push and read communication methods.
- Push → Bakuun sends mapping data to your system
- Read → Your system retrieves mapping data from Bakuun
Webhook → Mapping Endpoints Table Reference
| Field | Description |
| URL | The endpoint where mapping data is sent or retrieved |
| API Version | The API version used for the endpoint |
| Method | Defines whether the endpoint uses Push or Read |
| Error Rate | Percentage of failed requests, used to monitor performance |
| Status | Indicates endpoint state (Active, To set, Suspended) |
| Click + Add Endpoint to create a new endpoint. A modal will appear to select the method. | |
Add Endpoint
Click + Add Endpoint to create a new mapping endpoint. A modal will appear allowing you to select one or both methods:
- Push → Enables Bakuun to send mapping updates to your system
- Read → Enables Bakuun to retrieve mapping data from your system
Once selected, click Add to generate the endpoint.
Manage Endpoints
Click the … (three dots) next to an endpoint to access management options.
Update API Version
Allows you to view and update the API version used by the endpoint. It displays the current version, provides available versions for selection, and includes access to changelog details. Click Update version to apply changes.
Enable / Disable Endpoint
- Disable → Sets the endpoint status to Suspended
- Activate → Sets the endpoint status to Active
This can be used to temporarily stop data exchange without removing the endpoint.
Expire Key (Key Rotation)
Opens the key rotation modal to replace the current API key. It displays the masked key and last usage, requires selection of expiration timing, and requires password confirmation. Click Roll API Key to generate a new key. Once expired, the previous key will no longer be valid.
Delete Endpoint
Permanently removes the endpoint from the system. This action cannot be undone.
Important Notes
- Ensure endpoints are correctly configured before enabling them
- Monitor error rates to maintain integration stability
Webhook → ARI Endpoints
The ARI endpoints section allows you to configure webhook connections for Availability, Rates, and Inventory updates.
In Production, ARI endpoints support Push only, where Bakuun sends ARI updates to your system.
Webhook → ARI Endpoints Table Reference
| Field | Description |
| URL | The endpoint where ARI data is sent |
| API Version | The API version used for the endpoint |
| Method | Defines the integration type. ARI endpoints support Push only |
| Error Rate | Percentage of failed requests |
| Status | Indicates endpoint state (Active, To set, Suspended) |
| Click + Add Endpoint to create a new endpoint. A modal will appear to select the method. | |
Add Endpoint
Click + Add Endpoint to create a new ARI endpoint. A modal will appear with the available option:
- Push → Enables Bakuun to send ARI updates (availability, rates, inventory) to your system
Click Add to generate the endpoint.
Manage Endpoints
Click the … (three dots) next to an endpoint to access management options.
Update API Version
Allows you to view and update the API version used by the endpoint. It displays the current version, provides available versions for selection, and includes access to changelog details. Click Update version to apply changes.
Enable / Disable Endpoint
This can be used to temporarily stop ARI data exchange without removing the endpoint.
- Disable → Sets the endpoint status to Suspended
- Activate → Sets the endpoint status to Active
Expire Key (Key Rotation)
Opens the key rotation modal to replace the current API key. It displays the masked key and last usage, requires selection of expiration timing, and requires password confirmation. Click Roll API Key to generate a new key. Once expired, the previous key will no longer be valid.
Delete Endpoint
Permanently removes the endpoint from the system. This action cannot be undone.
Important Notes
- ARI endpoints support Push only
- Ensure endpoints are correctly configured before enabling them
- Monitor error rates to maintain integration stability
Webhook → Booking Endpoints
The Booking endpoints section allows you to manage webhook connections for booking-related events.
These endpoints support both sending and receiving booking data.
- Push → Your system sends booking updates to Bakuun
- Read → Your system receives booking events from Bakuun
Webhook → Booking Endpoints Table Reference
| Field | Description |
| URL | The endpoint used for booking data exchange |
| API Version | The API version used for the endpoint |
| Method | Defines whether the endpoint uses Push or Read |
| Error Rate | Percentage of failed requests, used to monitor endpoint performance |
| Status | Indicates the endpoint state: Active, To Set, or Suspended |
| Click + Add Endpoint to create a new endpoint. A modal will appear to select the method. | |
Add Endpoint
Click + Add Endpoint to create a new booking endpoint. A modal will appear allowing you to select one or both methods:
- Push → Enables your system to send booking events to Bakuun
- Read → Enables your system to receive booking events from Bakuun
Click Add to generate the endpoint.
Manage Endpoints
Click the … (three dots) next to an endpoint to access management options.
Update API Version
Allows you to view and update the API version used by the endpoint. It displays the current version, provides available versions for selection, and includes access to changelog details. Click Update version to apply changes.
Enable / Disable Endpoint
This can be used to temporarily stop booking data exchange without removing the endpoint.
- Disable → Sets the endpoint status to Suspended
- Activate → Sets the endpoint status to Active
Expire Key (Key Rotation)
Opens the key rotation modal to replace the current API key. It displays the masked key and last usage, requires selection of expiration timing, and requires password confirmation. Click Roll API Key to generate a new key. Once expired, the previous key will no longer be valid.
Delete Endpoint
Permanently removes the endpoint from the system. This action cannot be undone.
Important Notes
- Webhooks operate in real-time and impact live data flow
- Ensure endpoints are correctly configured before activating them
- Monitor error rates regularly to maintain integration stability
- Disable endpoints if they are no longer required