Webhooks
Webhooks are automated messages sent from Base to another system when certain events happen — can be thought as setting up a “notification” system between two applications.
Whenever a specific event occurs (like a booking being confirmed or cancelled), Base sends a message with details about the event (called a POST request) to a specified URL.
Via Zapier, or similar no-code tools, you can connect Base webhooks with over 8000+ apps, enabling powerful workflows without needing a developer.
Add a Webhook
Navigate to the Administrator settings in the left side menu → Settings → Webhooks.
Fill inn your Payload URL: This is the destination URL where Base will send the webhook data.
Example: https://example-system.com/webhooks/Add your preferred Secret: This is a shared secret used to verify the authenticity of the webhook request. Base includes this value in the request header, and you can use it to validate that the message really comes from Base. The secret itself can be anything.
Add the desired webhook Event → See description of these below.
Make the webhook active by toggle it on
.Click Add webhook.
You can activate or deactivate a webhook at any time using the toggle.
For the connection to work, make sure your system is ready to receive and process the JSON data which Base sends through the webhook.
Webhook Events
These are the current webhook events you can subscribe to:
Event | Description |
|---|---|
booking.online.confirmed | Triggered when an online booking is successfully confirmed in Base. |
booking.cancelled | Triggered when a booking is cancelled in Base. |
booking.refunded | Triggered when a booking is refunded in Base. |
marked.as.paid | Triggered when a booking is manually marked as paid in Base. |
Example Use Cases
1️⃣ Customer Books Online
→ This triggers Base to send a webhook to your system and your system reacts. In this case the reaction can be to grant access or updates a status.
2️⃣ Booking is Cancelled
→ This triggers Base to send a webhook and your system is notified instantly and can react by trigger actions on your end, like freeing up a resource.
3️⃣ Booking is Marked as Paid
→ This triggers Base to send a webhook to your system and your system reacts. In this case it could be to issue an invoice or update internal records.