Snelstart REST API
Authenticeer en maak je eerste zending aan.
Van token tot verzendlabel in vier stappen.
Maak een token aan, installeer een SDK of gebruik cURL, en post een zending. De verzendregel die je opgeeft, kiest de vervoerder en het verzendproduct. Verstuur de zending en het verzendlabel komt terug als document dat je kunt printen of naar Zippendo Printer kunt sturen.
Maak een API-token aan
Open de API-instellingen in het dashboard. Tokens beginnen met zipp_, worden één keer getoond en kunnen tot één merk worden beperkt.
API-instellingenInstalleer een SDK, of niet
npm, pip, Composer, go get, gem, Maven of NuGet. Elke SDK wordt gegenereerd uit de openbare OpenAPI-spec en dekt elk endpoint. cURL werkt net zo goed.
SDK-overzichtMaak een zending aan
Post de ontvanger, de pakketten en een verzendregel-id. De regel levert vervoerder, verzendproduct en afzenderadres. Verstuur daarna de zending, en de vervoerder geeft het verzendlabel en het trackingnummer terug.
Zendingen in de referentieLuister naar gebeurtenissen
Laat een webhook naar je server wijzen. Elke aflevering is een POST, ondertekend met HMAC-SHA256 over de ruwe body, wordt tot 5 keer geprobeerd, en elke poging staat in het afleverlogboek.
Snelstart webhooks
curl 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": [] }] }'Elke fout bevat naast de melding een machineleesbare code. Een opnieuw verstuurde webhook houdt dezelfde X-Webhook-Id, dus duplicaten overslaan kost één lookup.
Verzendlabels, track & trace en afhaalpunten, vanuit je eigen code.
MCP, webhooks en integraties uit één catalogus
Koppel Claude, Cursor of ChatGPT via OAuth, of stuur zendingsgebeurtenissen naar Klaviyo, Slack, Zapier en Make zonder zelf de koppelcode te schrijven.
SDK's
7
talen, gegenereerd uit de spec
Gebeurtenissen waarnaar je kunt luisteren
- order.created
- shipment.created
- shipment.dispatched
- tracking.updated
- shipment.error
Eén request erin, elke gebeurtenis eruit
Maak een zending aan met een verzendregel-id, en vervoerder, verzendproduct en afzenderadres worden voor je bepaald. Daarna komt elke wijziging als ondertekende webhook binnen op je endpoint.
Een MCP-server voor agents
Wijs Claude, Cursor of ChatGPT naar api.zippendo.com/mcp, en de agent maakt zendingen aan, volgt pakketten en leest je bestellingen met de rechten die jij goedkeurt.
Heb je alleen de vervoerders nodig?
- Verzendlabels
- Track & trace
- Afhaalpunten
- Verzendoffertes
API-toegang
100%
van de abonnementen, ook Free
Nieuwe vervoerders
1 week
is meestal de tijd die we nodig hebben om een vervoerder te koppelen die je nodig hebt
Waar je verder kunt
- Lees de snelstart
- Open de referentie
API-referentie
Elk endpoint, elke request body en response, met een playground.
- Kies een taal
SDK's
TypeScript, Python, PHP, Go, Ruby, Java en C#, gegenereerd uit dezelfde spec.
- Stel een endpoint in
Webhooks
Ondertekende afleveringen voor elke zendings- en bestellingsgebeurtenis.
- Bouw een kanaal
Eigen verkoopkanalen
Je eigen webshop of ERP als bron van bestellingen, gepusht of opgehaald via de API.
- Koppel een agent
MCP-server
Koppel Claude, Cursor of ChatGPT via OAuth aan je account.
Gidsen
- Lees de gids
API-integratie met vervoerders
Wat het kost om vervoerders zelf te koppelen, en wanneer één verzend-API de eenvoudigere weg is.
- Lees de gids
HS-codes
Vind het juiste tariefnummer voor elk product en waar het op de douanedocumenten komt.