Overview
The Webhook section allows you to configure endpoints that enable real-time communication between your system and Bakuun.
By setting up Mapping, ARI, and Booking endpoints, your system can automatically send and receive updates, ensuring timely data synchronization for availability, rates, inventory, and bookings.
💡 Note: Each endpoint displays key details such as method type (Push/Read), API version, error rate, and status, allowing you to monitor integration performance.
Webhook → Mapping Endpoints
The Mapping Endpoints section allows you to configure how mapping data between your system and Bakuun.
These endpoints support automated synchronization of mapping data using both push and pull communication models.
- Push → Bakuun sends mapping data to your system
- Read → Bakuun retrieves mapping data from your system
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 (e.g. V3) |
| 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 |
| Add Endpoint | Opens the configuration to create a new endpoint |
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 → Restores the endpoint 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 (ARI) data exchange between your system and Bakuun.
Unlike other webhook types, 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 (availability, rates, inventory) is sent |
| API Version | The API version used for the endpoint (e.g. V3) |
| Method | Defines the integration type. ARI endpoints support Push only |
| Error Rate | Percentage of failed requests, used to monitor endpoint performance |
| Status | Indicates the endpoint state: Active, To Set, or Suspended |
| Add Endpoint | Opens the configuration to create a new endpoint |
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 → Restores the endpoint 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 This can be used to temporarily stop ARI data exchange without removing the endpoint. 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 configure webhook connections for booking-related events between your system and Bakuun. These endpoints support real-time exchange of booking data, including new reservations, modifications, and cancellations, using both Push and Read models.
- Push → Your system sends booking events to Bakuun
- Read → Your system receives live booking events from Bakuun
Webhook → Booking Endpoints Table Reference
| Field | Description |
| URL | The endpoint where booking data is sent or received |
| API Version | The API version used for the endpoint (e.g. V2) |
| 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 |
| Add Endpoint | Opens the configuration to create a new endpoint |
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 → Restores the endpoint 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
- Ensure endpoints are correctly configured before enabling them
- Monitor error rates to maintain integration stability