> ## Documentation Index
> Fetch the complete documentation index at: https://partner.headout.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Booking status change

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](/docs/api-partner/v2/webhooks/create), 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

<Note>
  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.
</Note>

<ResponseExample>
  ```json Sample payload theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "bookingId": 123456789,
    "status": "COMPLETED",
    "eventTimestamp": "2024-01-15T10:30:00"
  }
  ```
</ResponseExample>


## OpenAPI

````yaml specs/openapi-v2-api-partner.yaml webhook bookingStatusChanged
openapi: 3.1.0
info:
  title: Headout API Docs - API Partner v2
  version: 0.0.1
servers:
  - url: https://www.headout.com
    description: Production server
  - url: https://www.sandbox-headout.com
    description: Sandbox server
security: []
paths: {}

````