Skip to main content
{
  "bookingId": 123,
  "status": "<string>",
  "eventTimestamp": "<string>"
}
{
  "bookingId": 123456789,
  "status": "COMPLETED",
  "eventTimestamp": "2024-01-15T10:30:00"
}
Webhook callback sent by Headout when a booking’s status changes. Your endpoint must respond within 45 seconds. Once your webhook is registered via Create webhook configuration, Headout sends a POST request to your configured URL whenever a booking’s status changes. Your endpoint must respond within 45 seconds with an appropriate HTTP status code.

​
Response & retry behavior

Your endpoint must return an HTTP response within 45 seconds (end-to-end call timeout).
  • 2xx — Delivery successful, no retry.
  • 4xx — Permanent failure, no retry.
  • 408, 429 — Retried (up to 4 times, same as 5xx).
  • 5xx — Retried up to 4 times with exponential backoff: 5s → 10s → 20s → 20s.
{
  "bookingId": 123456789,
  "status": "COMPLETED",
  "eventTimestamp": "2024-01-15T10:30:00"
}

Body

application/json
​
bookingId
integer
required

Unique booking identifier. Use this to look up the booking via the Get Booking endpoint.

​
status
string
required

The new status of the booking. Note: UNCAPTURED is never sent via webhook. See Booking Status.

​
eventTimestamp
string
required

Timestamp of when the status change occurred (local time). e.g. 2024-01-15T10:30:00. See ISO 8601.

Response

Request timeout. Retried up to 4 times with exponential backoff (5s → 10s → 20s → 20s).