REST API quickstart
Authenticate and create your first shipment.
Create a token, install an SDK or use cURL, and post a shipment. The shipping rule you name picks the carrier and service. Send the shipment, and the label comes back as a document you can print or send to Zippendo Printer.
Open API settings in the dashboard. Tokens start with zipp_, are shown once, and can be restricted to a single brand.
API settingsnpm, pip, Composer, go get, gem, Maven or NuGet. Every SDK is generated from the public OpenAPI spec and covers every endpoint. cURL works just as well.
SDK overviewPost the receiver, the parcels and a shipping rule id. The rule supplies carrier, service and sender address. Then send the shipment, and the carrier returns the label and tracking number.
Shipments in the referencePoint a webhook at your server. Every delivery is a POST signed with HMAC-SHA256 of the raw body, tried up to 5 times, with every attempt in the delivery log.
Webhooks quickstartcurl https://api.zippendo.com/orgs/org_8f3kd92ld0/shipments \ -H "Authorization: Bearer $ZIPPENDO_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "reference": "ORDER-1042", "type": "outbound", "shippingRuleId": "rule_3c4d5e6f", "parties": [{ "type": "receiver", "name": "Anna Jensen", "address1": "Vesterbrogade 12", "postalCode": "1620", "city": "København V", "countryCode": "DK", "email": "[email protected]" }], "parcels": [{ "weight": 2.5, "weightUnit": "kg", "dimensions": { "length": 30, "width": 20, "height": 10 }, "orderLines": [] }] }'Every error carries a machine-readable code next to the message. A retried webhook keeps the same X-Webhook-Id, so skipping duplicates is one lookup.
Connect Claude, Cursor or ChatGPT over OAuth, or send shipment events to Klaviyo, Slack, Zapier and Make without writing the glue.
SDKs
7
languages, generated from the spec
Events you can listen for
Create a shipment with a shipping rule id and the carrier, service and sender address are decided for you. Then every change lands on your endpoint as a signed webhook.
Point Claude, Cursor or ChatGPT at api.zippendo.com/mcp, and it creates shipments, tracks parcels and reads your orders with the permissions you approve.
Only need the carriers?
API access
100%
of plans, Free included
New carriers
1 week
is how long we usually take to connect one you need
Authenticate and create your first shipment.
Every endpoint, request body and response, with a playground.
TypeScript, Python, PHP, Go, Ruby, Java and C#, generated from the same spec.
Signed deliveries for every shipment and order event.
Your own shop or ERP as an order source, pushed in or pulled by the API.
Connect Claude, Cursor or ChatGPT to your account over OAuth.
What connecting carriers yourself takes, and when one shipping API is the simpler route.
Find the right tariff number for each product and where it goes on customs documents.