Sign in
Orders

Update the order's lead booker

Update the lead-booker details on an order. Stores the customer contact and tax information against the order header and, when a lead-booker Guest exists on the order, copies the same first and last name through to it so the operator-facing guest list and the order header stay aligned.

phone is validated against the site's country code and stored in E.164 format. Pass tax_address_id to copy one of the customer's saved addresses into the order's tax address; pass legal_name / tax_id / tax_id_type to record a tax identifier against the order for downstream invoicing.

When tax_id is provided, tax_id_type is recorded alongside it (or left null if not supplied). When tax_id is absent the type is ignored.

post/shop/orders/{orderId}/lead-booker

Request body

first_namestring

First name of the lead booker. Copied onto the order's lead-booker Guest so the operator-facing guest list and the order header stay aligned.

last_namestring

Last name of the lead booker.

emailstring email nullable

Lead booker's email address.

phonestring nullable

Lead booker's phone number, validated against the site's country code and stored in E.164 format.

tax_address_idstring nullable

ID of one of the customer's existing addresses to copy into the order's tax address. Useful for B2B sales where the invoice needs to carry a specific billing address.

legal_namestring nullable

The legal entity name to use on tax documents — typically a company name distinct from the lead booker's personal name.

tax_idstring nullable

The tax identifier (VAT number, ABN, etc.) to record on the order for downstream invoicing.

tax_id_type'tax_number' | 'passport' | 'other' nullable

The kind of tax identifier supplied — only meaningful when tax_id is also provided.

Example request

{
  "first_name": "Jane",
  "last_name": "Doe",
  "phone": "+447700900123",
  "tax_address_id": "5f8a1b2c-9d3e-4a5b-8c6d-7e8f9a0b1c2d",
  "legal_name": "Acme Hospitality Ltd",
  "tax_id": "GB123456789"
}

Response

The Order was successfully retrieved

Changes

No recorded changes to this endpoint across all 1 revision of this API.