---
title: "Setting Up and Using Webhooks"
description: "Set up and configure webhook integrations to automatically receive booking and conversation data from OnceHub when lifecycle events occur."
url: "https://help.oncehub.com/developers/webhooks/using-webhooks"
---

## What Can I Do With Webhooks?

[Section titled “What Can I Do With Webhooks?”](#what-can-i-do-with-webhooks)

Webhooks are a useful tool if you want to receive automatic notifications whenever a booking or conversation event occurs in your OnceHub account.

For example, you can use a webhook subscription to automatically send guest details to your server whenever a new booking is made.

You can register webhooks to send an HTTP POST request for specific types of booking or conversation events, or register a webhook to let you know when any booking or conversation lifecycle event takes place. [See all available webhook events and their payloads](https://help.oncehub.com/developers/api/#tag/webhook-events).

POST messages may contain sensitive customer data. Always use HTTPS when providing the receiving POST URL.

## Webhook Delivery Retries

[Section titled “Webhook Delivery Retries”](#webhook-delivery-retries)

If your endpoint does not return a successful `2xx` status code, the delivery is treated as failed and OnceHub retries it automatically.

Retries use exponential backoff, so the time between attempts increases over time.

Retries continue for up to about 3 days. If delivery still does not succeed within that retry window, the webhook is automatically disabled.

To avoid missed events, make sure your endpoint:

* Returns a `2xx` response as soon as the payload is accepted.
* Handles temporary errors and downtime gracefully.
* Logs failed deliveries so you can investigate and recover quickly.

## Check That Your Webhook is Configured Correctly

[Section titled “Check That Your Webhook is Configured Correctly”](#check-that-your-webhook-is-configured-correctly)

Once you have created your webhook subscription, you can check that it is configured correctly by using a service like [Webhook Tester](https://webhook.site/).

Simply configure your webhook subscription with a URL generated by one of these services, and create a sample booking in your account. The request testing tool lets you collect the HTTP requests you send to the specified URL, so that you can easily confirm, inspect, or debug the responses.

## Setting Up Webhook Integration With a SaaS Application

[Section titled “Setting Up Webhook Integration With a SaaS Application”](#setting-up-webhook-integration-with-a-saas-application)

Webhooks can be used to easily integrate OnceHub with a SaaS application. Once you have [registered a OnceHub account](https://account.oncehub.com/signup), setting up webhook integration with a SaaS application is simple:

1. [Create a webhook subscription](https://help.oncehub.com/developers/api/#tag/webhooks/POST/webhooks) by sending a POST request to the **/webhooks** endpoint, configured with the relevant event triggers and the URL where you want to receive data.
2. Receive booking or conversation data every time a booking or conversation lifecycle event is triggered.
3. Integrate OnceHub booking or conversation data into your application.