[Does a Fulfillment support one more multiple tracking numbers?

Shopify Partner
60 3 24

The 2020-01 Fulfillment API documentation says that each fulfillment only supports a single tracking number:


Each fulfillment supports a single tracking number. If you need to use multiple tracking numbers, then you should create separate fulfillments.

Listed in fulfillment properties is the `tracking_numbers` property which is clearly an array. The description suggests that multiple tracking numbers are supported in a single fulfillment instance:


Screen Shot 2020-04-11 at 6.52.26 PM.png


Which is correct?


Some clarity and an update to the documentation would be great.


Thank you!

Replies 4 (4)
Shopify Partner
8 1 6

Came here to post the same thing. It seems to be the case for both `tracking_numbers` and, correspondingly, `tracking_urls`.

Even more confusing - the GraphQL Fulfillment object contains a `tracking_info` field that uses the singular `number` and `url`:

I haven't tested this recently, but I believe I've been able to add multiple tracking numbers and URLs to a single fulfillment via the REST API.

So, are the singular properties merely a recommendation at this point? If so, the GraphQL values must be simply grabbing the first item from a list and crossing fingers there aren't any more?

Would love some clarification on this as well.

Shopify Partner
37 2 5

Bumping this. How can I add another tracking number to a fulfillment?

Shopify Partner
8 1 6

I haven't tested this since last year, but I am fairly certain that you can have multiple tracking numbers on a fulfillment, or "add a tracking number to a fulfillment", by supplying them all as an array under "tracking_numbers" via either of the Fulfillment update REST endpoints:

PUT /admin/api/2020-01/orders/{order_id}/fulfillments/{fulfillment_id}.json

POST /admin/api/2020-01/fulfillments/{fulfillment_id}/update_tracking.json

It's a bit confusing, as the examples only show the ability to update "tracking_number" (singular), but "tracking_numbers" is still listed as a Fulfillment property and I'm fairly certain you can provide a list under a "tracking_numbers" key.

For what it's worth, Shopify's documentation for the Fulfillment resource also says:

Each fulfillment supports a single tracking number. If you need to use multiple tracking numbers, then you should create separate fulfillments.

In my opinion, it seems that "multiple tracking numbers per fulfillment" is a softly-deprecated behavior that Shopify still allows for legacy support, but they discourage it now. It would be great if they would address this specifically.

Shopify Partner
5 0 10

Atm there is no PUT method on REST 




Not in documentation, and a PUT request returns [406][Not Acceptable].

Both tested with "tracking_numbers" and "numbers" -array.


Tested POST /fulfillments/{$fulfillmentId}/update_tracking.json -

no error, but it just removes any tracking previously added and does not add any number (seems buggy).


This is a problem.

If you sell an item that is bulky, so you send out 2 parcels because the 2nd one is "small",

then you have 2 tracking numbers ...

and can add only one.