Skip to main content
POST
/
fulfillments
/
events
/
{lineItemId}
Create Fulfillment Event
curl --request POST \
  --url https://staging-api.puppetvendors.com/fulfillments/events/{lineItemId} \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "status": "<string>",
  "happenedAt": "<string>",
  "city": "<string>",
  "province": "<string>",
  "country": "<string>",
  "zip": "<string>",
  "message": "<string>"
}
'
V2 Preview — This endpoint is part of the V2 API preview. Breaking changes may occur.

​
Overview

Create a tracking event for a line item’s fulfillment. Vendor tokens can only add events to their own line items. The line item must already be fulfilled.

​
Path Parameters

​
lineItemId
string
required
Line item ObjectId.

​
Request Body

​
status
string
required
One of in_transit, out_for_delivery, delivered, failed_delivery.
​
happenedAt
string
ISO 8601 timestamp; defaults to now.
​
city
string
​
province
string
​
country
string
​
zip
string
​
message
string

​
Response

201
{
  "success": true,
  "data": {
    "_id": "507f1f77bcf86cd799439020",
    "lineItemId": "507f1f77bcf86cd799439015",
    "status": "in_transit",
    "happenedAt": "2026-04-15T08:30:00Z"
  }
}

​
Example

curl -X POST "https://staging-api.puppetvendors.com/fulfillments/events/507f1f77bcf86cd799439015" \
  -H "x-access-token: YOUR_VENDOR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "in_transit",
    "city": "Austin",
    "province": "TX",
    "country": "US",
    "message": "Package scanned at origin facility"
  }'

​
More Examples

Mark as delivered with timestamp 
curl -X POST "https://staging-api.puppetvendors.com/fulfillments/events/507f1f77bcf86cd799439015" \
  -H "x-access-token: YOUR_VENDOR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "delivered",
    "message": "Signed by J. Smith",
    "occurredAt": "2026-05-19T10:15:00Z",
    "location": "New York, NY"
  }'