> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Een API-token aanmaken

> Maak een API-token aan in Instellingen → API-instellingen zodat je eigen systemen met Zippendo kunnen verbinden - naam, vervaldatum, rechten, het token eenmalig kopiëren en het verwijderen.

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](/docs/api-reference/overview) 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](/docs/nl/tutorials/settings-team-brands). Eerste verzoek: [REST API-quickstart](/docs/nl/quickstarts/rest-api). Verzendprijzen in de checkout: [Een verzendofferte opvragen](/docs/nl/how-to/shipping-quotes).

<Info>
  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.
</Info>

## 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.

<Frame caption="API-tokens: naam, het begin van elk token, rechten en laatste gebruik">
  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/create-an-api-token/01-api-settings-light.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=54ad5593fbe564f4af3ae92f8e856083" alt="Tabblad API-instellingen met de lijst met API-tokens en API-token toevoegen in de kop" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/create-an-api-token/01-api-settings-light.png" />

  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/create-an-api-token/01-api-settings-dark.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=5210c966f5cd21230429a4e4519588b4" alt="Tabblad API-instellingen met de lijst met API-tokens en API-token toevoegen in de kop" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/create-an-api-token/01-api-settings-dark.png" />
</Frame>

## 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

<Steps>
  <Step title="Open het venster">
    Klik op **API-token toevoegen**, of op **Eerste token aanmaken** als de lijst leeg is. Het venster **API-token aanmaken** opent.
  </Step>

  <Step title="Geef het token een naam">
    Vul **Tokennaam \*** in, bijvoorbeeld "Warehouse WMS". Stel eventueel **Verloopt over (dagen)** en **Beperken tot merk** in.
  </Step>

  <Step title="Kies de rechten">
    Vink aan wat het token mag doen, of klik op **Alles selecteren**.
  </Step>

  <Step title="Maak het aan">
    Klik op **Token aanmaken**. Je ziet **API-token aangemaakt**, en **API-token aangemaakt** opent met het volledige token.
  </Step>
</Steps>

<Frame caption="API-token aanmaken: naam, optionele vervaldatum, daarna de rechten">
  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/create-an-api-token/02-create-modal-light.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=936dd54add372f6ab1698a965dceedf9" alt="Venster API-token aanmaken met Tokennaam, Verloopt over (dagen) en selectievakjes voor rechten" className="block dark:hidden" width="2880" height="2800" data-path="images/nl/how-to/create-an-api-token/02-create-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/create-an-api-token/02-create-modal-dark.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=909b24f9542834444def9524957ae4b0" alt="Venster API-token aanmaken met Tokennaam, Verloopt over (dagen) en selectievakjes voor rechten" className="hidden dark:block" width="2880" height="2800" data-path="images/nl/how-to/create-an-api-token/02-create-modal-dark.png" />
</Frame>

| 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](/docs/nl/how-to/create-a-brand) 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.

<Frame caption="Alle rechten, met Alles selecteren aangezet">
  <img src="https://mintcdn.com/zippendo/rHO_KsHyFOKxfIiU/images/nl/how-to/create-an-api-token/03-permissions-light.png?fit=max&auto=format&n=rHO_KsHyFOKxfIiU&q=85&s=010510441b8b31f828b87c9fe56b448d" alt="Rechten bij API-token aanmaken met selectievakjes voor Lezen en Schrijven, inclusief Alles bekijken en Alles bewerken" className="block dark:hidden" width="2880" height="2800" data-path="images/nl/how-to/create-an-api-token/03-permissions-light.png" />

  <img src="https://mintcdn.com/zippendo/rHO_KsHyFOKxfIiU/images/nl/how-to/create-an-api-token/03-permissions-dark.png?fit=max&auto=format&n=rHO_KsHyFOKxfIiU&q=85&s=0db6e022a09d915c8ea45ab563520794" alt="Rechten bij API-token aanmaken met selectievakjes voor Lezen en Schrijven, inclusief Alles bekijken en Alles bewerken" className="hidden dark:block" width="2880" height="2800" data-path="images/nl/how-to/create-an-api-token/03-permissions-dark.png" />
</Frame>

| Recht | Omvat |
| - | - |
| **Zendingen bekijken** / **Zendingen bewerken** | Zendingen |
| **Verzendregels bekijken** / **Verzendregels bewerken** | Verzendregels, en [verzendoffertes](/docs/nl/how-to/shipping-quotes) |
| **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](/docs/nl/how-to/roles-and-permissions).

## 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.**

<Frame caption="API-token aangemaakt: kopieer het token voordat je het venster sluit">
  <img src="https://mintcdn.com/zippendo/rHO_KsHyFOKxfIiU/images/nl/how-to/create-an-api-token/04-token-secret-light.png?fit=max&auto=format&n=rHO_KsHyFOKxfIiU&q=85&s=5dcda31ef6d24fcb67ff00d1dc0fddc7" alt="Venster API-token aangemaakt met het token, een knop Kopiëren en een waarschuwing Belangrijk" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/create-an-api-token/04-token-secret-light.png" />

  <img src="https://mintcdn.com/zippendo/rHO_KsHyFOKxfIiU/images/nl/how-to/create-an-api-token/04-token-secret-dark.png?fit=max&auto=format&n=rHO_KsHyFOKxfIiU&q=85&s=308bdaef0d0e565364d7811989946380" alt="Venster API-token aangemaakt met het token, een knop Kopiëren en een waarschuwing Belangrijk" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/create-an-api-token/04-token-secret-dark.png" />
</Frame>

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.

<Warning>
  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](/docs/nl/knowledge-base/api-token-authentication-errors).
</Warning>

## Het token gebruiken

Je ontwikkelaar stuurt het token mee met elk verzoek:

```bash theme={null}
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](/docs/api-reference/overview), waar elk verzoek en antwoord wordt beschreven. Kant-en-klare clients: [SDK's](/docs/nl/sdks/overview). Limieten: [Limieten](/docs/api-reference/rate-limits).

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](/docs/nl/settings/brands).

## 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.

<Frame caption="API-token verwijderen?: typ de naam in hoofdletters om te bevestigen">
  <img src="https://mintcdn.com/zippendo/rHO_KsHyFOKxfIiU/images/nl/how-to/create-an-api-token/05-delete-token-light.png?fit=max&auto=format&n=rHO_KsHyFOKxfIiU&q=85&s=6574e17114a4ba28ee86a22b83c233dc" alt="Venster API-token verwijderen? met een veld om de naam te typen ter bevestiging" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/create-an-api-token/05-delete-token-light.png" />

  <img src="https://mintcdn.com/zippendo/rHO_KsHyFOKxfIiU/images/nl/how-to/create-an-api-token/05-delete-token-dark.png?fit=max&auto=format&n=rHO_KsHyFOKxfIiU&q=85&s=55279a5ca278f130adfc8691f4070b50" alt="Venster API-token verwijderen? met een veld om de naam te typen ter bevestiging" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/create-an-api-token/05-delete-token-dark.png" />
</Frame>

## Gerelateerd

* [Webhooks](/docs/nl/how-to/webhooks): Zippendo laat je systeem weten wanneer er iets gebeurt, in plaats van dat je systeem het vraagt.
* [Slack, Klaviyo en andere apps koppelen](/docs/nl/how-to/connect-an-integration): kant-en-klare koppelingen die geen API-token nodig hebben.
* [API voor eigen kanalen](/docs/nl/how-to/custom-channel-api): push bestellingen uit je eigen winkel of systeem naar Zippendo.
* [Een verzendofferte opvragen](/docs/nl/how-to/shipping-quotes): verzendprijzen in de checkout.
* [MCP-authenticatie](/docs/nl/mcp/authentication): verbind een AI-agent zonder een token te plakken.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.