---
title: "Location Booking Update Webhook"
method: POST
path: "/v1/webhook/location-booking-update"
tags: ["Use case / Location booking", "Webhooks / Inbound"]
---

# Location Booking Update Webhook

`POST /v1/webhook/location-booking-update`

Inbound webhook to receive location booking updates from external systems.

## Request body

- LocationBookingUpdatePayload
  - `updates` LocationBookingUpdate[], required
    - `match` BookingMatchTarget
      - `matches_all` BookingMatch[]
        - `booking_reference` FieldMatchInput
          - `matches_any` string[]
        - `name` FieldMatchInput
          - `matches_any` string[]
    - `id` string, uuid, nullable — ID of the booking in Qargo
    - `event_time` string, date-time — Time of the event in UTC using ISO 8601 format
    - `execution_status` ExecutionStatusUpdate
      - `execution_statuses` BookingExecutionStatus[] — List of execution statuses to update
        - `event_time` string, date-time, required — Time of the event in UTC
        - `ok` boolean, required — Is the status ok
        - `type` string, required — Type of the status
        - `remark` string, nullable — extra remark about the status
    - `status` 'TO_REQUEST' | 'REQUESTED' | 'BOOKED' | 'CANCELLED' | 'REJECTED'
    - `question_answers` object — Question answers to update on the order. Mapping is configured in Qargo

## Response `200`

Successful Response

- LocationBookingUpdateResponse — Response schema for the location booking update webhook. This schema is used to return errors or success messages.
  - `errors` ErrorStatus[], nullable — List of errors that occurred during the webhook processing. If empty/omitted, the webhook was processed successfully.
    - `error_type` 'USER_INPUT_ERROR' | 'INTERNAL_ERROR' | 'NOT_SUPPORTED', required
    - `error_message` string, nullable — (User visible) error message

## Other responses

- `400` — Bad Request — invalid input or malformed request
- `401` — Unauthorized — missing or invalid authentication credentials
- `403` — Forbidden — insufficient permissions for this operation
- `422` — Validation Error
- `429` — Too Many Requests — rate limit exceeded. See the `Retry-After` header
- `500` — Internal Server Error
- `503` — Service Unavailable — temporarily unable to handle the request

---

[API](https://skmtc.dev/qargo/apis/qargo-tms-api.md) · [All operations](https://skmtc.dev/qargo/apis/qargo-tms-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qargo/qargo-tms-api/revisions/17297902e7ce/schema)