shopify-admin-api

Query the order's fulfillmentOrders first to get the fulfillment order ID, then call the fulfillmentCreate GraphQL mutation with trackingInfo and notifyCustomer. Since API version 2022-07, the legacy REST Fulfillments endpoint no longer works for this.

Use the bulkOperationRunQuery GraphQL mutation instead of paginated queries. Poll currentBulkOperation until status is COMPLETED, then download the resulting JSONL file from the provided URL immediately, since it is a time-limited signed URL.

GraphQL is recommended for most operations because its cost-based rate limit (1000 cost units/second) is more forgiving than REST's 40 requests/second, and it avoids over-fetching. REST remains practical for simple lookups like customers/search by email.

Shopify mutations return HTTP 200 even when they fail at the application level. Always check the userErrors array in the mutation response and throw or handle the error when it is non-empty before treating the operation as successful.

The Shopify API replaces the tags field rather than merging it. Fetch the customer's current tags first, append the new tag to the list, and send the combined comma-separated string in the update request.

GraphQL requires global IDs in the format gid://shopify/Product/123, not plain numeric IDs. Convert REST numeric IDs by prefixing them with the appropriate resource GID before using them in queries or mutations.