POST
/v1/fulfillments/webhookFulfillment webhook
Receives Shopify fulfillment webhooks and propagates tracking info to reseller stores.
Receives a Shopify fulfillments/create webhook from a source store and propagates tracking information back to the corresponding reseller store order. This endpoint is authenticated via HMAC signature verification.
How it works
- A source store fulfills an order in Shopify
- Shopify sends the fulfillment webhook with HMAC headers
- The platform finds the source store by shop domain
- Looks up the completed sync job matching the source order
- Creates a fulfillment on the reseller store with the tracking information
The endpoint returns 200 OK immediately — processing is fire-and-forget.
Tracking fields
| Field | Description |
|---|---|
tracking_number | Carrier tracking number |
tracking_company | Carrier name (defaults to “Unknown” if absent) |
tracking_url | Tracking URL (optional) |
Required headers
| Header | Description |
|---|---|
X-Shopify-Hmac-SHA256 | Base64-encoded HMAC-SHA256 signature of the raw request body |
X-Shopify-Shop-Domain | Originating Shopify shop domain |
Responses
200
Response
200 200 OK
{
"statusCode": 200,
"message": ""
}