Skip to main content
POST
/
fulfillments
/
events
/
bulk
Bulk Create Fulfillment Events
curl --request POST \
  --url https://staging-api.puppetvendors.com/fulfillments/events/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "events": [
    {}
  ]
}
'

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 Preview — This endpoint is part of the V2 API preview. Breaking changes may occur.

​
Overview

Create multiple fulfillment events in a single request. Maximum 100 events per request. Each event is processed independently — partial success is reported in the response.

​
Request Body

​
events
array
required
Array of { lineItemId, status, happenedAt?, city?, province?, country?, zip?, message? }.

​
Response

200
{
  "success": true,
  "data": {
    "successCount": 98,
    "failedCount": 2,
    "results": [
      { "lineItemId": "507f1f77bcf86cd799439015", "success": true },
      { "lineItemId": "507f1f77bcf86cd799439016", "success": false, "message": "Line item not found" }
    ]
  }
}

​
Example

curl -X POST "https://staging-api.puppetvendors.com/fulfillments/events/bulk" \
  -H "x-access-token: YOUR_VENDOR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      { "lineItemId": "507f1f77bcf86cd799439015", "status": "in_transit" },
      { "lineItemId": "507f1f77bcf86cd799439016", "status": "delivered" }
    ]
  }'

​
More Examples

Track multiple items at once 
curl -X POST "https://staging-api.puppetvendors.com/fulfillments/events/bulk" \
  -H "x-access-token: YOUR_VENDOR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      {
        "lineItemId": "665a1b2c3d4e5f6a7b8c9d0e",
        "status": "in_transit",
        "message": "Package picked up by carrier",
        "location": "Los Angeles, CA"
      },
      {
        "lineItemId": "665a1b2c3d4e5f6a7b8c9d0f",
        "status": "delivered",
        "message": "Left at front door",
        "location": "San Francisco, CA",
        "occurredAt": "2026-05-19T14:30:00Z"
      }
    ]
  }'