Skip to main content

Update Delivery Appointment

PATCH 
/api/tiktok-shop/:integrationInstance/fbt/appointments/:appointment

Reschedules an appointment or changes which inbound orders ride on it.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

The window and destination are required on every update, not optional: the membership is replaced wholesale and the whole appointment is re-validated, so a partial payload would leave it ambiguous which window is being checked. Omitting inbound_order_ids empties the appointment.

Permission: integrations.update.

Body

  • fbt_warehouse_id — required string, max 64 characters. The destination fulfillment center the delivery is booked into. One appointment serves one destination.
  • window_start_at — required date-time.
  • window_end_at — required date-time, must be after window_start_at.
  • inbound_order_ids — optional array of integers, max 10 entries. TikTok allows at most ten inbound orders on one delivery. Membership is replaced wholesale on every write, so an omitted list empties the appointment.
  • status — optional string. One of requested, confirmed, missed, cancelled.
  • reference — optional, nullable string, max 255 characters. The booking reference from the TikTok seller portal.
  • carrier_name — optional, nullable string, max 255 characters.
  • pro_number — optional, nullable string, max 64 characters.

Cross-record rules are enforced on write and returned as 422: at least four business days' lead time, one destination for the whole appointment, at most ten members, and every member still awaiting receipt.

Validation errors: a 422 from this endpoint returns the specific reason and a field-addressed errors object (e.g. "Inbound order IBR… is bound for a different FBT warehouse."), not a generic message — an inbound order may only be attached to an appointment at the SAME fulfillment centre.

Request​

Responses​

OK

Response Headers
    Content-Type