Skip to main content
POST
Create Fulfillment
V2 Alpha — This endpoint is part of the V2 API preview. Breaking changes may occur.

Overview

Create a fulfillment for one or more line items belonging to the authenticated vendor. This creates a fulfillment in Shopify and updates the line item records in PuppetVendors. Optionally sends a shipping notification to the customer.
Vendor Token Required — This endpoint requires a vendor-scoped JWT token. Merchant tokens will receive a 403 error.

Use Cases

  • Automate fulfillment from a vendor’s warehouse or 3PL system
  • Bulk-fulfill orders by scripting API calls from a shipping platform
  • Connect external fulfillment services to the vendor’s workflow

Request Body

string[]
required
Array of PuppetVendors line item IDs (_id values) to fulfill. At least one is required. All line items must belong to the authenticated vendor.
string
Shipment tracking number.
string
Shipping carrier name (e.g. "Royal Mail", "UPS", "FedEx").
string
URL for tracking the shipment. Must be a valid URL.
boolean
default:"false"
Whether to send a shipping notification email to the customer.

Response

200

Partial Failure

If some items fail to fulfill, each item reports individually:
200

Error Responses

400

Example

More Examples

Fulfill with tracking and notify customer