API-tokens aanmaken en beheren

Open TrekMail in Claude, kies Connect, meld je aan en geef toegang. Je hoeft geen API-token te maken. Bekijk rechten of verbreek de verbinding bij AI-agenten en API → Tokens → Verbonden apps.

Je eigen White Label-merk: gebruik het MCP-adres uit je eigen merkdashboard en geef de connector je merknaam. Voeg deze toe als custom connector; de openbare TrekMail-vermelding gebruikt de TrekMail-aanmelding en vervangt je merkverbinding niet.

API-tokens bepalen wat een toepassing of agent in uw account kan doen. Elk token heeft een naam, bereiken, optionele domeinbeperkingen en een vervaldatum.

Een MCP-client verbinden? Als deze browserautorisatie ondersteunt, voegt u https://trekmail.net/mcp toe als externe MCP-server en keurt u de toegang goed in de browser. Meestal hoeft u geen token te maken of te plakken. Handmatige tm_live_-tokens zijn bedoeld voor scripts, CI-taken, zelfgehoste MCP en clients die deze procedure niet ondersteunen. Zie AI-agenten verbinden (MCP).

E-mail lezen met één sleutel

Kies op Pro en Agency E-mail lezen bij het maken van een API-sleutel. Het expliciete recht is mailboxes:messages:read; mailboxes:read toont alleen adressen en instelgegevens. Alle mailboxen omvat huidige en toekomstige mailboxen; je kunt ook alleen gekozen domeinen en mailboxen toestaan. Bestaande sleutels krijgen niet automatisch nieuwe rechten.

Gebruik de accountsleutel met de GET-routes hieronder. Verzenden, verwijderen en wijzigen vereisen nog steeds aparte berichtgegevens en rechten. Gehoste MCP accepteert OAuth, geen tm_live_ of tm_msg_. Een fout over het tokentype vertelt de agent welke route of autorisatie nodig is.

GET /api/v1/mailboxes/{mailbox}/messages
GET /api/v1/mailboxes/{mailbox}/folders
GET /api/v1/mailboxes/{mailbox}/messages/{uid}
GET /api/v1/mailboxes/{mailbox}/messages/{uid}/raw
GET /api/v1/mailboxes/{mailbox}/messages/{uid}/attachments/{index}

App-rechten kiezen en bewerken

Open de details van een API-sleutel of verbonden app, kies Toegang bewerken, bekijk de wijzigingen en bevestig. Het geheim van de API-sleutel blijft hetzelfde. Minder rechten, bronnen of looptijd beperkt ook bestaande mailboxtokens en annuleert nog niet begonnen verzendingen. Nieuwe OAuth-verbindingen kunnen direct worden beperkt; uitbreiding vereist nieuwe toestemming. Bewerken van een oude verbinding verbreekt deze en bewaart de keuzes voor opnieuw verbinden. Berichttokens kunnen alleen rechten verliezen of eerder verlopen.

Voordat u begint

• Alle abonnementen, waaronder Nano, kunnen API-tokens maken. Nano-abonnementen zijn beperkt tot Email Verifier-bereiken (verify:read, verify:write).
• Starter-abonnementen bieden alleen-lezen infrastructuurbereiken en volledige bereiken voor Drive en Email Verifier. Starter kan doorsturen ook in het dashboard beheren, maar schrijftoegang voor doorsturen via de API (mailboxes:forwarding:write) vereist Pro of Agency. Pro en Agency ontgrendelen alle bereiken.
• De eigenaar kan alle accountreferenties beheren. Een gedelegeerd lid met toestemming voor API-tokens kan alleen zelf gemaakte referenties beheren en alleen bereiken en domeinen verlenen die al in het lidmaatschap aanwezig zijn.
• Tip: Klik op Rondleiding starten op de pagina AI-agenten en API voor een korte uitleg over verbindingsopties, tokens, verbonden apps en het auditlogboek.

Een Drive-automatiseringstoken maken

De Drive-API en MCP-tools gebruiken bewerkingstokens (tm_live_...). Selecteer alleen de Drive-bereiken die de workflow nodig heeft:

• Alleen-lezen rapportage: drive:account:read, drive:mailbox:read of drive:addon:read.
• Uploadautomatisering: voeg drive:account:write of drive:mailbox:write toe.
• Openbare leveringslinks: voeg drive:account:share of drive:mailbox:share toe.
• Permanente opschoning: gebruik drive:account:purge of drive:mailbox:purge alleen in een afzonderlijk, streng beheerd token.

Aankoop, groottewijziging en opzegging van de Drive-add-on zijn niet beschikbaar via API-tokens. Agenten kunnen de add-onstatus en prijzen lezen met drive:addon:read, maar abonnementswijzigingen blijven in het dashboard.

Een White Label-automatiseringstoken maken

White Label gebruikt vijf bereiken voor bewerkingstokens: branding:read, branding:write, members:read, members:write en activity:read. Ze verschijnen alleen zolang het account toegang tot White Label heeft. members:write is als gevaarlijk gemarkeerd, omdat het toegang kan verwijderen en de sleutels van iemand anders kan intrekken.

Selecteer voor een alleen-lezen status- en auditintegratie branding:read, members:read en activity:read. Voeg branding:write alleen toe voor het instellen van het merk en DNS. Voeg members:write alleen toe wanneer de automatisering personen moet uitnodigen of wijzigen.

Tijdens de respijtperiode voor opzegging behoudt de eigenaar de drie leesbereiken voor herstel, terwijl schrijfbewerkingen en gedelegeerde White Label-referenties niet meer werken. Reactivering herstelt een ingetrokken referentie niet; maak of autoriseer een nieuwe.

Een token maken

1. Ga naar AI-agenten en API → Tokens.
2. Klik op Token maken.
3. Vul het formulier in:
   • Naam: Een label om het token te herkennen (bijvoorbeeld "Claude-agent", "CI/CD-pijplijn").
   • Vervaldatum: Kies 7 dagen, 30 dagen, 90 dagen, een aangepaste datum of nooit.
   • Bereiken: Selecteer welke bewerkingen het token mag uitvoeren. Alle toegestane bereiken zijn standaard aangevinkt.
   • Domeinbeperking: Kies "Alle domeinen (huidige en toekomstige)", "Alleen geselecteerde domeinen" of "Alle domeinen (huidige en toekomstige) behalve…" om enkele domeinen uit te sluiten.
4. Klik op Token maken.

Na het maken wordt het token in platte tekst één keer weergegeven. Kopieer het onmiddellijk of gebruik de knop Downloaden om het als een .txt-bestand op te slaan.

Het token kan niet opnieuw worden bekeken. Sla het veilig op voordat u de bevestiging sluit.

Een berichttoken maken

Met berichttokens kunnen agenten e-mail lezen en verzenden vanuit een specifieke mailbox. Ze staan los van bewerkingstokens en worden programmatisch via de API gemaakt met uw bewerkingstoken.

Uw agent voert de volgende aanroep uit om een berichttoken te maken:

curl -s -X POST \
  -H "Authorization: Bearer tm_live_your_ops_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-message-token-my-agent" \
  -d '{"name":"my-agent","scopes":["messages:read","messages:send"]}' \
  https://trekmail.net/api/v1/mailboxes/{MAILBOX_ID}/message-tokens

Kies de kleinste bereiken die de workflow nodig heeft:

Het token in platte tekst (tm_msg_...) wordt één keer teruggegeven. Voeg het aan uw MCP-configuratie toe als TREKMAIL_MESSAGE_TOKEN.

Berichttokens zijn beschikbaar bij de abonnementen Pro en Agency. Het bewerkingstoken moet het bereik mailboxes:message-tokens:manage hebben.

Gebruik external_account_id voor een verbonden Gmail- of ander extern postvak. Als ontvangers in plaats daarvan een geautoriseerd bedrijfsadres moeten zien, gebruikt u ook een identity_id die door het identiteiten-endpoint wordt teruggegeven. Zie Verzenden als-adressen via API en MCP.

Tokenindeling

TrekMail gebruikt twee tokenvoorvoegsels om tokentypen van elkaar te onderscheiden:

De eerste 8 tekens na het voorvoegsel worden als zichtbaar voorvoegsel in het dashboard opgeslagen voor eenvoudige herkenning.

Bereiken

Bereiken bepalen wat het token kan doen. Wat u kunt selecteren hangt af van uw abonnement:

• Nano: Alleen Email Verifier (verify:read, verify:write). Door Drive Storage toe te voegen, krijgt het account ook de Drive-API- en MCP-mogelijkheden waarop het recht heeft.
• Starter: Volledige toegang tot Drive en Email Verifier en alleen-lezen toegang tot al het overige (domeinen, mailboxen, doorsturen, e-mailfilters, automatisch antwoord, migraties, tickets, SMTP, Cloudflare). Gebruik het dashboard voor schrijfacties die Starter niet via de API beschikbaar stelt, zoals migraties maken, tickets beantwoorden of het automatische antwoord wijzigen.
• Pro en Agency: Volledige toegang. Lezen, schrijven, maken en verwijderen voor alle families, plus berichttokens voor het lezen en verzenden van e-mail via de API.

White Label-bereiken zijn een add-onrecht en geen omweg in de abonnementstabel. Ze worden alleen aangeboden wanneer White Label actief is; de eigenaar behoudt tijdens de respijtperiode voor opzegging alleen-lezen hersteltoegang.

Zie API-bereiken en abonnementstoestemmingen voor informatie over elk bereik.

Domeinbeperkingen

Tokens hebben standaard toegang tot alle domeinen van uw account, ook tot domeinen die u later toevoegt. Twee keuzes beperken dat:

• Alleen geselecteerde domeinen: het token bereikt de aangevinkte domeinen en verder niets. Een domein dat u later toevoegt, blijft buiten bereik tot u het token bewerkt en het aanvinkt.
• Alle domeinen (huidige en toekomstige) behalve…: het token bereikt alle domeinen behalve de aangevinkte, ook domeinen die u later toevoegt. Zo houdt u uw agents weg van de mail van één klant zonder het token bij elk nieuw domein aan te passen.

Een beperkt token ontvangt 404-antwoorden wanneer het toegang probeert te krijgen tot bronnen op andere domeinen; de API gedraagt zich alsof die domeinen niet bestaan. In beide gevallen kan het token ook geen accountbrede instellingen wijzigen die domeinen buiten zijn bereik zouden raken, zoals de standaard voor nieuwe mailboxen.

Voor een teamlid dat tot enkele domeinen beperkt is, betekent "behalve…" de eigen domeinen min de aangevinkte; domeinen die later aan het account worden toegevoegd, horen er niet bij. Verwijdert u een uitgesloten domein en voegt u het opnieuw toe, dan telt het als een nieuw domein: sluit het dan opnieuw uit.

Een token opnieuw genereren

Genereer een token opnieuw als u het geheim weer nodig hebt of als het geheim mogelijk is uitgelekt. Het token behoudt naam, rechten, domeinen, mailboxen, vervaldatum en auditgeschiedenis. Alleen het geheim verandert.

1. Ga naar AI-agenten en API → Tokens en open de Details van het token.
2. Klik op Opnieuw genereren.
3. Kies wanneer het oude geheim stopt met werken: Nu, Over 1 uur, Over 24 uur, Over 3 dagen of Over 7 dagen. Het oude geheim werkt nooit langer dan het token zelf.
4. Klik op Opnieuw genereren en kopieer het nieuwe geheim. Net als bij een nieuw token wordt het maar één keer getoond.

Zolang het oude geheim nog werkt, tonen de details van het token tot wanneer en bieden ze Nu uitschakelen. Vervang het geheim vóór dat moment in elke app: aanvragen die daarna nog het oude geheim gebruiken, ontvangen 401 Unauthorized.

Berichttokens (tm_msg_...) die met het oude geheim zijn gemaakt, stoppen tegelijk met werken. Een app die zelf berichttokens maakt, kan met het nieuwe geheim nieuwe maken. Kies Nu als het geheim mogelijk is uitgelekt.

Een token intrekken

1. Ga naar AI-agenten en API → Tokens.
2. Zoek het token in de lijst.
3. Klik op Intrekken.
4. Bevestig de intrekking.

Ingetrokken tokens werken onmiddellijk niet meer. Elke API-aanvraag die een ingetrokken token gebruikt, ontvangt 401 Unauthorized.

Intrekking is permanent en kan niet ongedaan worden gemaakt. Maak een nieuw token als u de toegang wilt herstellen.

Tokenstatus

Tokens hebben drie statussen:

Gebruik het statusfilter op de pagina Tokens om tokens per status te bekijken.

Auditspoor

Elke keer dat een token wordt aangemaakt, opnieuw gegenereerd of ingetrokken, verschijnt dat op het tabblad Auditlogboek. Gebeurtenissen bevatten de tokennaam, actie en tijd.

Snelle oplossingen

• "Bereiken niet beschikbaar voor uw abonnement": Uw abonnement bevat deze bereiken niet. Nano blijft beperkt tot verify:read en verify:write (voeg een Drive Storage-add-on toe om ook de drive:*-bereiken te krijgen). Starter voegt leestoegang voor alle infrastructuurfamilies toe, plus volledige toegang tot Drive en Email Verifier. Pro en Agency ontgrendelen overal schrijftoegang.
• Token in platte tekst kwijt: Het token kan niet worden hersteld, maar u kunt het opnieuw genereren: open de Details, klik op Opnieuw genereren en kopieer het nieuwe geheim. Het token behoudt zijn instellingen.
• Het token werkt, maar geeft 404 terug voor sommige domeinen: Het token heeft waarschijnlijk een domeinbeperking. Open Details van het token, kies Toegang bewerken en voeg de ontbrekende domeinen toe, of schakel over naar "Alle domeinen (huidige en toekomstige)" of "Alle domeinen (huidige en toekomstige) behalve…".
• White Label-bereik geeft scope_blocked_by_entitlement terug: Activeer White Label opnieuw en maak of autoriseer vervolgens een referentie met het vereiste bereik.
• Een gedelegeerd token stopte na een rolwijziging: Beperkte, opgeschorte of verwijderde lidtoegang trekt de betrokken referenties onmiddellijk in. Maak een nieuw token nadat de eigenaar de juiste toegang heeft hersteld.