Skip to main content

Carrier tracking events in order histories

An order’s events can now include three kinds that come from the carrier’s tracking updates: Each also carries fulfillmentOrderId and fulfillmentId, like the other shipment events.

Shipping and webhooks (beta)

These routes are new and marked beta. They need the new scopes below on a project API key. New scopes: orders.write, shipping.read, shipping.write, shipping_labels.write (buying and voiding labels, which spends the store’s money), webhooks.read and webhooks.write. See Webhooks for event types, payloads and signature checks, and Shipping from your own tool for a walkthrough.

Migration

Requests pinned to 2026-11-14 or earlier don’t receive the carrier tracking events; the rest of the order history is unchanged. They also can’t send fulfillmentStatus or updatedSince to GET /v1/orders; pin 2026-11-17 to use them.