- API
- REST met JSON over HTTPS. API v3 is de huidige versie; v2 is legacy en gaat sinds april 2026 in onderhoudsmodus: geen nieuwe functies, en endpoints in onderhoudsmodus zijn dicht voor nieuwe gebruikers.
- Nieuwe accounts
- Een account dat na 13 april 2026 is aangemaakt, kan via v2 geen pakketten meer aanmaken. Een nieuwe koppeling bouw ik daarom op de v3 Shipments API.
- Authenticatie
- HTTP Basic met de publieke en geheime sleutel van een API-integratie, of OAuth2 met client credentials: een token van een uur, zonder refresh token. Per integratie kun je OAuth2 verplicht stellen.
- Sleutels
- Je maakt ze in Sendcloud onder Instellingen, Integraties, Sendcloud API. Ze worden één keer getoond; daarna zie je ze niet meer.
- Scopes
- Sinds oktober 2026 noemt elk endpoint de OAuth2-scopes die het nodig heeft (read: en write:). Vraag je geen scopes aan, dan krijgt het token alle scopes van de integratie.
- Limieten
- 1.000 GET-verzoeken per minuut en 100 schrijfverzoeken (POST, PATCH, PUT, DELETE) per minuut, met een piek van 15 per seconde. Daarboven volgt HTTP 429. De limiet geldt per account en wordt gedeeld door alle sleutels van dat account.
- Batches
- Synchroon tot 15 pakketten per aanroep, asynchroon tot 50. Orders gaan in batches van maximaal 100, alles of niets. Lijsten pagineren met een cursor in de Link-header.
- Fouten bij de vervoerder
- Anders dan in v2 geeft v3 bij een fout van de vervoerder toch HTTP 200, met een foutobject in het antwoord. Een zending wijzigen kan in v3 niet; je maakt een nieuwe.
- Webhooks
- Per integratie in te stellen en ondertekend met HMAC-SHA256 in de header Sendcloud-Signature. Je endpoint moet binnen 10 seconden met 2xx antwoorden, anders volgen tot 10 pogingen in ongeveer anderhalf uur. Meldingen kunnen in een andere volgorde binnenkomen.
- Testen
- Er is geen aparte testomgeving. Testlabels maak je gratis met de verzendoptie Unstamped letter (sendcloud:letter), of je annuleert een echt label op tijd. Een label dat je binnen 42 dagen annuleert en dat niet is verzonden, wordt terugbetaald.
- Labels
- Standaard PDF in de maat van de vervoerder, meestal A6; ook ZPL en PNG, in A4, A5 of A6. De maat kies je bij het ophalen, niet bij het aanmaken.
- Douane
- Buiten de EU maakt Sendcloud de handelsfactuur of het CN22/CN23-formulier zelf aan. Daarvoor zijn een factuurnummer en een exportreden verplicht, en per artikel een hs-code en het land van herkomst.
- Verbinding
- Alleen TLS 1.2 of hoger en alleen IPv4. Het servercertificaat wisselt regelmatig, dus certificate pinning raadt Sendcloud af.
- Vervoerders
- Meer dan 170 vervoerders, in Nederland onder meer PostNL, DHL, DPD, UPS, GLS en bol.
- AI-assistenten
- Sendcloud heeft een eigen MCP-server die API v3 ontsluit voor AI-assistenten en agents, met inloggen via OAuth.