{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/api/booking-flow/order/webhook/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Order item webhook

\n

To receive live updates for an order item, we can set up a webhook notification for you. When an order item status changes (for example from PENDING to OK), details are sent directly to the URL you specify.

\n

Authentication

\n

For added security, our webhook supports basic access authentication. Provide us with a username and password of your choosing and the webhook will include them in the Authorization header of the request.

\n

If this option is not possible for you, we can provide a list of our IP addresses so that you can set up a whitelist for your endpoint.

\n

Response

\n

The body of the response is ignored. A 200 status code response confirms the request has been received and will be processed. All other status codes are treated as a failed attempt - another webhook request will be sent later.

\n

Example

\n

Let's look at an example with our imaginary partner, Acme.

\n

They've set up a URL for our webhook at https://www.acme-partner.com/api/v1/items/musement/webhook. They've added additional authentication:

\n\n

Before submitting the request, the username and password must be base-64 encoded first: Sm9oblNtaXRoOlN3b3JkZmlzaA==

\n

The example below shows a typical webhook request along with the partner's URL and encoded authentication:

\n
\n
' \\\\\n-H 'Content-Type: application/json' \\\\\n--data-raw '{\n\t"order_id": "13459345",\n\t"order_uuid": "8e9e5c6e-ea7d-4934-8753-f00954f30d00",\n\t"order_created": "2018-12-10T13:12:40+0000",\n\t"order_updated": "2018-12-10T13:12:40+0000",\n\t"order_version": "16",\n\t"order_item_uuid": "11045e18-e3ca-42e1-acb4-0d5be75036fd",\n\t"order_item_created": "2018-12-10T13:12:40+0000",\n\t"order_item_updated": "2018-12-10T13:12:40+0000",\n\t"order_item_version": "22",\n\t"order_item_status": "OK"\n}'`, `73071234788430496000`)\"\n >\n
Copy
\n
Copied
\n
\n 
curl -X POST 'https://www.acme-partner.com/api/v1/items/musement/webhook' \\\n-H 'Authorization: Basic <redacted>' \\\n-H 'Content-Type: application/json' \\\n--data-raw '{\n\t\"order_id\": \"13459345\",\n\t\"order_uuid\": \"8e9e5c6e-ea7d-4934-8753-f00954f30d00\",\n\t\"order_created\": \"2018-12-10T13:12:40+0000\",\n\t\"order_updated\": \"2018-12-10T13:12:40+0000\",\n\t\"order_version\": \"16\",\n\t\"order_item_uuid\": \"11045e18-e3ca-42e1-acb4-0d5be75036fd\",\n\t\"order_item_created\": \"2018-12-10T13:12:40+0000\",\n\t\"order_item_updated\": \"2018-12-10T13:12:40+0000\",\n\t\"order_item_version\": \"22\",\n\t\"order_item_status\": \"OK\"\n}'
\n
\n

Fallback

\n

Unfortunately, webhook delivery is not guaranteed. It is strongly recommended to set up a fallback, allowing your integration to check an order item's status by calling /orders/{orderUuid}.

","headings":[{"value":"Order item webhook","depth":1},{"value":"Authentication","depth":2},{"value":"Response","depth":2},{"value":"Example","depth":2},{"value":"Fallback","depth":2}]},"contentItem":{"data":{"lastModified":"2025-12-18T16:31:42.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"8811cfd0-b643-5936-9484-3416a57ac147__redocly content/api/booking-flow/order/webhook/","seo":{"title":"Order item webhook","description":"Set up a webhook to receive notifications for changes to order items.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api/booking-flow/order/webhook.md","pageBaseUrl":"/api/booking-flow/order/webhook","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Order item webhook","id":"order-item-webhook"},{"depth":2,"value":"Authentication","id":"authentication"},{"depth":2,"value":"Response","id":"response"},{"depth":2,"value":"Example","id":"example"},{"depth":2,"value":"Fallback","id":"fallback"}]},"data":{"title":"","redirectFrom":["/guide/orders-management/order-item-webhook/","/api/partner/booking-flow/order/order-item-webhook/","/api/partner/booking-flow/order/webhook/"],"seo":{"description":"Set up a webhook to receive notifications for changes to order items."}},"catalogInfo":null,"link":"/api/booking-flow/order/webhook/","sidebarName":"__alternative-sidebar__-data-24763-api-sidebars.yaml","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}