Skip to main content
PUT
/
fulfillments
/
{fulfillmentId}
Update Fulfillment
curl --request PUT \
  --url https://staging-api.puppetvendors.com/fulfillments/{fulfillmentId} \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "trackingNumber": "<string>",
  "shippingCarrier": "<string>",
  "trackingUrl": "<string>",
  "notifyCustomer": true
}
'

Documentation Index

Fetch the complete documentation index at: https://dev.puppetvendors.com/llms.txt

Use this file to discover all available pages before exploring further.

V2 Alpha — This endpoint is part of the V2 API preview. Breaking changes may occur.

​
Overview

Update tracking information on an existing fulfillment belonging to the authenticated vendor. This syncs the updated tracking to Shopify and optionally re-notifies the customer. Only fulfillments for the vendor’s own line items can be updated.
Vendor Token Required — This endpoint requires a vendor-scoped JWT token. Merchant tokens will receive a 403 error.

​
Use Cases

  • Correct tracking numbers — Fix a mistyped tracking number after fulfillment
  • Update carrier — Change the shipping carrier if initially set incorrectly
  • Re-notify customers — Resend shipping notifications with corrected info

​
Path Parameters

​
fulfillmentId
string
required
The line item ID (fulfillment is stored on the line item record).

​
Request Body

All fields are optional. Only provided fields will be updated.
​
trackingNumber
string
Updated tracking number.
​
shippingCarrier
string
Updated shipping carrier name.
​
trackingUrl
string
Updated tracking URL. Must be a valid URL.
​
notifyCustomer
boolean
Whether to send a notification email to the customer with the updated tracking.

​
Response

200
{
  "success": true,
  "data": {
    "message": "Fulfillment updated successfully"
  }
}

​
Error Response

404
{
  "success": false,
  "error": {
    "message": "Fulfillment not found",
    "code": "NOT_FOUND"
  }
}

​
Example

curl -X PUT "https://staging-api.puppetvendors.com/fulfillments/507f1f77bcf86cd799439015" \
  -H "Content-Type: application/json" \
  -H "x-access-token: YOUR_VENDOR_JWT_TOKEN" \
  -d '{
    "trackingNumber": "1Z999AA10123456784",
    "shippingCarrier": "UPS",
    "trackingUrl": "https://www.ups.com/track?tracknum=1Z999AA10123456784",
    "notifyCustomer": true
  }'

​
More Examples

Update tracking info after shipping 
curl -X PUT "https://staging-api.puppetvendors.com/fulfillments/507f1f77bcf86cd799439015" \
  -H "Content-Type: application/json" \
  -H "x-access-token: YOUR_VENDOR_JWT_TOKEN" \
  -d '{
    "trackingNumber": "1Z999AA10123456784",
    "shippingCarrier": "UPS",
    "trackingUrl": "https://www.ups.com/track?tracknum=1Z999AA10123456784",
    "notifyCustomer": true
  }'