How to set up webhooks for bookings, orders and customers.
Webhooks tell your own system the moment something happens in Timeo, such as a new booking, a completed order or a new customer.
- Who it is for
- Owners and developers
- Plan
- Team only
Create a webhook endpoint
- Open Settings > Advanced settings > Webhooks.
- In Create endpoint, enter your URL (https).
- Add a Description (optional).
- Under Events, tick what it should receive: booking.created, booking.updated, booking.cancelled, booking.completed, order.created, order.completed, order.refunded, customer.created, review.created, class.reserved or class.cancelled.
- Tap Create endpoint.
- Copy the Signing secret now. It will not be shown again.
- In your system, verify each request by computing HMAC-SHA256 over the raw body with the secret and comparing it with the X-Timeo-Signature header.
Test and monitor
- Tap View endpoint to see Subscribed events and Recent deliveries with Succeeded, Failed or Retrying.
- Tap Send test ping to check your endpoint, and Resend to send a delivery again.
- Use Disable to pause an endpoint and Enable to turn it back on.
What your customers see
- Nothing changes for customers. Your endpoint health shows as Healthy, Failing, Idle or Disabled.
Common problems
- My endpoint shows Failing.
- Open it and check Recent deliveries. Your server must answer with a success status quickly. Fix it, then use Resend or Send test ping.
- I lost the signing secret.
- It is only shown once. Tap Delete on the endpoint and create it again to get a new secret.
Related guides
More in Account and settings, or start with the getting started guide. Still stuck? Contact us.