The orderCreate mutation now supports multiple tracking numbers for each fulfillment

We’ve added a trackingNumbers field to OrderCreateFulfillmentInput, so you can attach multiple tracking numbers to a fulfillment when importing orders.

If you use the orderCreate mutation to import orders that ship in more than one package, you no longer need to update the fulfillment after creation to add additional tracking numbers. Instead, you can include all tracking numbers upfront when you create the order.

Use the trackingNumbers field to pass an array of tracking number strings, for example:

trackingNumbers: ["1Z999AA10123456784", "1Z999AA10123456785"]

The trackingCompany value you provide applies to every tracking number in the array. This behavior is consistent with how FulfillmentTrackingInput already works on the fulfillmentCreate mutation.

If you provide both the singular trackingNumber and the plural trackingNumbers, the singular value takes precedence. In that case, the value of trackingNumber is used and trackingNumbers is ignored. This ensures that your existing integrations continue to work without any changes.

This field is available starting in API version 2026-10.

Learn more

• orderCreate mutation reference
• OrderCreateFulfillmentInput
• Manage fulfillments