2 juni 2026Klantenservice

Verbind met de initdesk API in 15 minuten

De initdesk API is live — issue een token, vind je organisatie-ID en lijst tickets met curl in één sessie.

De initdesk API is vandaag beschikbaar op developers.initdesk.com, met verzoeken naar https://api.initdesk.com.

Als je niet zeker weet of je de API, webhooks of BYOD nodig hebt, lees eerst API, webhooks of BYOD — dit bericht gaat ervan uit dat je wilt dat jouw code initdesk aanroept (tickets, requesters, berichten of Help Center-content aanmaken of lezen).

Hieronder staat het kleinste pad naar een werkende call: token, organisatie-ID, één curl, en daarna de OpenAPI-spec voor al het andere.

Wat je nodig hebt voordat je begint

Een initdesk-account waar je Account Owner of Admin bent (alleen die rollen kunnen API-tokens uitgeven).
Het numerieke organisatie-ID uit Settings → General. API-paden gebruiken dit nummer — niet de string public_id uit product-URL's.
Een plek om het token veilig op te slaan. initdesk slaat server-side een hash op; je ziet de ruwe token slechts één keer bij aanmaak.

Issue een organisatie-token

Open Settings → API access.
Genereer een nieuw organization-scoped integration token.
Kopieer het token direct naar je secrets manager of password vault.

Stuur het bij elk verzoek mee met de custom header:

X-Initdesk-Token: YOUR_TOKEN_HERE

Dat token mag alleen resources benaderen voor de organisatie waarvoor het is uitgegeven. Calls naar URL's van een andere organisatie geven 403 Forbidden. Ongeldige of ingetrokken tokens geven 401 of 403 waar van toepassing. Trek gecompromitteerde tokens in op hetzelfde instellingenscherm.

Details: Authentication and limits.

Je eerste verzoek: bevestig de organisatie

Vervang ORG_ID en YOUR_TOKEN in de voorbeelden hieronder.

curl -sS \
  -H "X-Initdesk-Token: YOUR_TOKEN" \
  "https://api.initdesk.com/organizations/ORG_ID/"

Een succesvol antwoord bevestigt dat je op de juiste tenant zit en toont organisatieconfiguratie die ticketgedrag kan beïnvloeden (bijvoorbeeld of auto-tagging is ingeschakeld). Bij 401 of 403, controleer het token opnieuw en of ORG_ID overeenkomt met Settings → General.

Lijst inboxes (nodig voordat je tickets aanmaakt)

Tickets worden aangemaakt in een specifieke inbox. Lijst ze om een inbox id te kopiëren voor latere POST-calls:

curl -sS \
  -H "X-Initdesk-Token: YOUR_TOKEN" \
  "https://api.initdesk.com/organizations/ORG_ID/inboxes/"

Lijst-endpoints geven gepagineerde JSON terug: count, next, previous en results (default page size 20). Volg next-URL's totdat je hebt wat je nodig hebt.

Lijst tickets (read path)

curl -sS \
  -H "X-Initdesk-Token: YOUR_TOKEN" \
  "https://api.initdesk.com/organizations/ORG_ID/tickets/"

Standaard worden spam-tickets uitgesloten. Om met spam te werken, geef is_spam=true door. Filter op requester met customer_id wanneer je het API-id van de klant kent.

Voor zoeken en preset filters, gebruik het search tickets-endpoint gedocumenteerd in de API reference index — handig voor ops-dashboards zonder je hele inbox te exporteren.

Ticket `id` vs `public_id` (en waar berichten leven)

Elk ticket heeft twee identifiers:

Veld	Gebruik
`id`	Primary key in API-URL's (`/tickets/{id}/`, `/tickets/{id}/messages/`)
`public_id`	Menselijk leesbaar nummer in e-mailonderwerpen en de UI ("Ticket #1234")

Gebruik altijd id in API-calls. Toon public_id aan klanten wanneer je het bekende label nodig hebt.

De ticketrij is de container (subject, status, assignee, inbox, tags). De thread — antwoorden, interne notities, systeemevents — staat in messages:

/organizations/{organization_id}/tickets/{ticket_id}/messages/

Haal een ticket op voor metadata; lijst berichten wanneer je het volledige gesprek nodig hebt. Veldgedrag staat in Entities and relationships.

OpenAPI, paginering en rate limits

OpenAPI schema: https://api.initdesk.com/schema.yaml — genereer clients of verken elk pad onder /organizations/{organization_id}/.
Paginering: page-number lists met count, next, previous, results.
Rate limits: 60 requests per minute per token voor de meeste endpoints. Ticket creation wordt ook per organisatie op uurbasis gedropt. Bij 429 Too Many Requests, back off met exponentiële delay en retry.

Tickets aanmaken, antwoorden, Help Center-artikelen synchroniseren en klanten beheren zijn allemaal gedocumenteerd in de developer reference — dit bericht stopt bij read/list zodat je auth kunt verifiëren voordat je data schrijft.

Vragen over beta-endpoints of toegang: support@initdesk.com.

initdesk is een AI help desk voor kleine teams. De API is vandaag gelanceerd naast developers.initdesk.com. Meer op Product Updates en X @initdeskhq.