Een API-token aanmaken

Met een API-token kunnen je eigen systemen, of een ontwikkelaar die voor je werkt, verbinding maken met Zippendo: zendingen aanmaken, bestellingen lezen, webhooks registreren en alles wat verder in de API-referentie staat. Je maakt tokens aan onder API-instellingen. Zippendo toont het volledige token maar één keer, direct nadat je het hebt aangemaakt. Rondleiding door Instellingen: Instellingen, team en merken. Eerste verzoek: REST API-quickstart. Verzendprijzen in de checkout: Een verzendofferte opvragen.

Elk abonnement bevat API-tokens: Free tot 2, Standard 5, Growth 10, Pro en Enterprise onbeperkt. Bij de limiet mislukt het aanmaken van een token met Je hebt de limiet van je abonnement bereikt. Upgrade je abonnement of verwijder iets wat je niet meer gebruikt. Verwijder een token dat je niet meer gebruikt, of upgrade.

Waar je het vindt

Open het organisatiemenu onderaan de zijbalk, klik op Beheren en dan op het tabblad API-instellingen. De knop om een token aan te maken is API-token toevoegen rechtsboven.

De lijst met API-tokens

Kolom	Wat het toont
Naam	De Tokennaam die je hebt ingevuld.
Token	De eerste tekens van het token gevolgd door `...`. Het volledige token wordt hier nooit getoond.
Rechten	Maximaal drie rechten, zoals Zendingen bekijken; de rest is ingeklapt. Geen rechten als er geen zijn gekozen.
Laatst gebruikt	Wanneer het token voor het laatst is gebruikt, of Nooit.
Aangemaakt door	Het teamlid dat het heeft aangemaakt.
Verloopt	De vervaldatum, of Nooit. Een datum in het verleden wordt rood getoond.
Aangemaakt	Wanneer het is aangemaakt.

Het enige wat je in de lijst met een token kunt doen, is het Verwijderen. Je kunt een token niet bewerken of hernoemen. Zolang er nog geen tokens zijn, toont de lijst Geen API-tokens en een knop Eerste token aanmaken.

Een token aanmaken

Open het venster

Klik op API-token toevoegen, of op Eerste token aanmaken als de lijst leeg is. Het venster API-token aanmaken opent.

Geef het token een naam

Vul Tokennaam * in, bijvoorbeeld “Warehouse WMS”. Stel eventueel Verloopt over (dagen) en Beperken tot merk in.

Kies de rechten

Vink aan wat het token mag doen, of klik op Alles selecteren.

Maak het aan

Klik op Token aanmaken. Je ziet API-token aangemaakt, en API-token aangemaakt opent met het volledige token.

Venster API-token aanmaken met Tokennaam, Verloopt over (dagen) en selectievakjes voor rechten — API-token aanmaken: naam, optionele vervaldatum, daarna de rechten

Veld	Verplicht	Wat je invult
Tokennaam *	Ja	Een naam die je vertelt waar het token wordt gebruikt, zoals “Production API” of “Webhook Service”. Maximaal 100 tekens.
Beperken tot merk	Nee	Alleen zichtbaar als je organisatie merken heeft. Kies een merk en Apps en systemen die dit token gebruiken, kunnen alleen de gegevens van dit merk zien en wijzigen. De standaard is Geen merk (hele organisatie). Je kunt dit later niet wijzigen.
Verloopt over (dagen)	Nee	Een getal van 1 tot 365. Het token werkt na zoveel dagen niet meer. Laat het leeg voor een token dat nooit verloopt.
Rechten *	Ja, minstens één	Wat het token mag lezen en wijzigen. Zie de lijst hieronder.

Token aanmaken blijft grijs tot het token een naam en minstens één recht heeft.

Rechten

Elk gebied heeft een Lees-recht (Gegevens bekijken en lezen) en een Schrijf-recht (Aanmaken, bijwerken en verwijderen). Een Schrijf-recht omvat Lees voor hetzelfde gebied.

Recht	Omvat
Zendingen bekijken / Zendingen bewerken	Zendingen
Verzendregels bekijken / Verzendregels bewerken	Verzendregels, en verzendoffertes
Vervoerders bekijken / Vervoerders bewerken	Gekoppelde vervoerders
Adressen bekijken / Adressen bewerken	Afzenderadressen
Organisatie bekijken / Organisatie bewerken	De gegevens van je organisatie
Teamleden bekijken / Teamleden bewerken	Teamleden
API-tokens bekijken / API-tokens bewerken	Andere API-tokens
Alles bekijken / Alles bewerken	Alles hierboven behalve API-tokens, plus bestellingen, verkoopkanalen, printers, webhooks, automatiseringen, integraties en rollen

Bestellingen, verkoopkanalen, printers, webhooks, automatiseringen en integraties hebben geen eigen recht: een token dat ze nodig heeft, moet Alles bekijken of Alles bewerken hebben. Geen van beide omvat API-tokens, dus vink ook API-tokens bewerken aan als het token andere tokens moet aanmaken of verwijderen. Dezelfde rechten worden gebruikt voor eigen rollen.

Kopieer het token (één keer)

API-token aangemaakt toont het volledige token, dat met zipp_ begint. Het venster waarschuwt: Kopieer dit token. Nadat je dit venster sluit, kun je het niet meer zien.

Venster API-token aangemaakt met het token, een knop Kopiëren en een waarschuwing Belangrijk — API-token aangemaakt: kopieer het token voordat je het venster sluit

Klik op Kopiëren. Je ziet Token gekopieerd naar het klembord. Als je Kan het token niet kopiëren ziet, selecteer het token dan en kopieer het met de hand. Sluit daarna het venster. Als je het token kwijtraakt, verwijder het dan en maak een nieuw aan.

Behandel het token als een wachtwoord. Zet het niet in code die anderen kunnen zien of op een webpagina. Als het uitlekt, verwijder het dan (zie “Een token verwijderen” hieronder) en maak een nieuw aan. Verzoeken die mislukken: Authenticatiefouten bij API-tokens.

Het token gebruiken

Je ontwikkelaar stuurt het token mee met elk verzoek:

curl https://api.zippendo.com/orgs/{orgId}/shipments \
  -H "Authorization: Bearer zipp_YOUR_TOKEN" \
  -H "Content-Type: application/json"

{orgId} is de ID van je organisatie, niet de naam in de adresbalk van de app. Een ontwikkelaar kan die opvragen met de Orgs-verzoeken in de API-referentie, waar elk verzoek en antwoord wordt beschreven. Kant-en-klare clients: SDK’s. Limieten: Limieten. Een token zonder merk kan een enkel verzoek op één merk richten met de header X-Zippendo-Brand. Een token dat met Beperken tot merk is aangemaakt, blijft altijd binnen zijn merk. Zie Merken.

Een token verwijderen

Klik op Verwijderen op de rij van het token. API-token verwijderen? vraagt je de naam van het token in hoofdletters te typen, bijvoorbeeld WAREHOUSE WMS, en dan op Verwijderen te klikken. Je ziet API-token verwijderd. Elk systeem dat het token gebruikt, kan niet meer verbinden. Verwijderen kan niet ongedaan worden gemaakt, en een token pauzeren kan niet.

Venster API-token verwijderen? met een veld om de naam te typen ter bevestiging — API-token verwijderen?: typ de naam in hoofdletters om te bevestigen

Gerelateerd

Webhooks: Zippendo laat je systeem weten wanneer er iets gebeurt, in plaats van dat je systeem het vraagt.
Slack, Klaviyo en andere apps koppelen: kant-en-klare koppelingen die geen API-token nodig hebben.
API voor eigen kanalen: push bestellingen uit je eigen winkel of systeem naar Zippendo.
Een verzendofferte opvragen: verzendprijzen in de checkout.
MCP-authenticatie: verbind een AI-agent zonder een token te plakken.

Overzicht

Zendingen

Bestellingen en verkoopkanalen

Vervoerders

Een vervoerder koppelen

Een integratie koppelen

Printen

Automatisering

Account

Zoeken en dashboard

API en events

Een API-token aanmaken

Waar je het vindt

De lijst met API-tokens

Een token aanmaken

Rechten

Kopieer het token (één keer)

Het token gebruiken

Een token verwijderen

Gerelateerd

​Waar je het vindt

​De lijst met API-tokens

​Een token aanmaken

​Rechten

​Kopieer het token (één keer)

​Het token gebruiken

​Een token verwijderen

​Gerelateerd

Waar je het vindt

De lijst met API-tokens

Een token aanmaken

Rechten

Kopieer het token (één keer)

Het token gebruiken

Een token verwijderen

Gerelateerd