---
title: "Tokens"
description: "Elk token dat je in een bericht kunt zetten, waarmee Pyn het invult, de tekst waarop het terugvalt als de waarde ontbreekt, en hoe datums en namen worden opgemaakt."
sidebar:
  order: 3
area: flows
feature: steps
appPath: /flows/home
lastVerified: 2026-11-15
version: "2026-10-23"
audience: admin
related:
  - flows/steps/format-a-message
  - flows/steps/choose-recipients-and-cc
  - flows/automations/enroll-from-a-spreadsheet
  - integrations/hibob/field-mapping
intercom:
  - id: "6024180"
    title: List of supported tokens
    url: https://intercom.help/pyn/en/articles/6024180-list-of-supported-tokens
    note: Pyn 1 article
  - id: "6010962"
    title: Add personalization tokens
    url: https://intercom.help/pyn/en/articles/6010962-add-personalization-tokens
    note: Pyn 1 article
  - id: "6005713"
    title: Personalize your content using tokens and custom senders
    url: https://intercom.help/pyn/en/articles/6005713-personalize-your-content-using-tokens-and-custom-senders
    note: Pyn 1 article
  - id: "6023197"
    title: Personalize your Buddy Pyns with Tokens
    url: https://intercom.help/pyn/en/articles/6023197-personalize-your-buddy-pyns-with-tokens
    note: Pyn 1 article
translation:
  source: flows/steps/reference-tokens.mdx
  sourceSha: e10e1379be5cfe5ae62f7a0ec7a37e8c261fc545
---

Een token is een markering die Pyn vervangt wanneer een bericht voor één ontvanger wordt opgemaakt. Typ `@` in de editor om er een in te voegen; in een Raw HTML-e-mail of een Raw HTML Block schrijf je het als Liquid-tag, `{{ principal.preferredName }}`. `principal`-tokens gaan over de ingeschreven medewerker, `recipient`-tokens over de persoon die het bericht ontvangt; in een bericht aan de medewerker zelf zijn dat dezelfde persoon.

Ontbreekt een waarde, dan toont het token zijn terugvaltekst uit de tabellen hieronder, tenzij je op het token een eigen terugvaltekst instelt. Namen, afdelingen en functietitels komen uit het medewerkersrecord in [Directory](https://support.pyn.ai/nl/directory/employees/).

## Tokens in de editor

| Token | Waarde | Terugvaltekst |
| --- | --- | --- |
| `date.reference` | De referentiedatum van de enrollment | reference date |
| `principal.preferredName` | Roepnaam, anders het eerste woord van de weergavenaam | Employee |
| `principal.firstName` | Eerste woord van de weergavenaam (of de officiële naam) | Employee |
| `principal.preferredFullName` | Roepnaam plus de achternaam uit de weergavenaam | Employee |
| `principal.legalName` | Officiële naam, anders de weergavenaam | Employee |
| `principal.jobTitle` | Functietitel | Job Title |
| `principal.department` | Afdeling | department |
| `principal.location` | Locatie | location |
| `principal.startDate` | Startdatum | start date |
| `principal.startDate.dayAfter` | De dag na de startdatum | start date |
| `principal.startDate.nextBusinessDay` | De eerstvolgende werkdag na de startdatum | start date |
| `principal.tenure` | Hele jaren sinds de diensttijddatum (of startdatum) op het moment van verzenden: "1 year", "3 years" | tenure |
| `principal.birthday` | Verjaardag als dag en maand, bijvoorbeeld "28 Jul" | Birthday |
| `principal.nextBirthday` | De eerstvolgende verjaardag op of na de referentiedatum | next Birthday |
| `principal.nextAnniversary` | Het eerstvolgende jubileum van de startdatum op of na de referentiedatum | next Anniversary |
| `principal.managerName` | Weergavenaam van de manager | Manager |
| `principal.managerPreferredName` | Roepnaam van de manager | Manager |
| `principal.managerEmail` | Zakelijk e-mailadres van de manager | manager email |
| `principal.buddy.name` | Weergavenaam van de buddy | Buddy |
| `principal.buddy.preferredName` | Roepnaam van de buddy | Buddy |
| `principal.buddy.preferredFullName` | Roepnaam en achternaam van de buddy | Buddy |
| `principal.buddy.email` | Zakelijk e-mailadres van de buddy | buddy email |
| `principal.buddy.startDate.nextBusinessDay` | De werkdag na de startdatum van de buddy | start date |
| `principal.hrbp.name` | Weergavenaam van de HR-businesspartner | HRBP |
| `principal.hrbp.preferredName` | Roepnaam van de HR-businesspartner | HRBP |
| `principal.hrbp.preferredFullName` | Roepnaam en achternaam van de HR-businesspartner | HRBP |
| `principal.hrbp.email` | Zakelijk e-mailadres van de HR-businesspartner | HRBP email |
| `recipient.preferredName`, `recipient.firstName`, `recipient.preferredFullName`, `recipient.legalName` | Als hierboven, voor de ontvanger | Employee |
| `recipient.department`, `recipient.location` | Als hierboven, voor de ontvanger | department, location |
| `recipient.startDate` | De startdatum van de ontvanger | start date |
| `recipient.birthday`, `recipient.nextBirthday`, `recipient.nextAnniversary` | Als hierboven, voor de ontvanger | Birthday, next Birthday, next Anniversary |
| `recipient.surveyLink` | Een link die op het record van de ontvanger is opgeslagen; wordt een link, of niets | |

Het **Subject** van een e-mail biedt een kleinere set: de roepnaam, verjaardag, eerstvolgende verjaardag en eerstvolgende jubileum van de principal en de ontvanger. De **Summary** en **Description** van een Jira-ticket bieden twaalf `principal`-tokens: `principal.department`, `principal.email`, `principal.employeeNumber`, `principal.jobTitle`, `principal.legalName`, `principal.location`, `principal.managerEmail`, `principal.managerName`, `principal.name`, `principal.preferredFullName`, `principal.preferredName` en `principal.startDate`.

## Tokens voor Raw HTML

Een Raw HTML-e-mail of een [Raw HTML Block](https://support.pyn.ai/nl/flows/steps/format-a-message/#raw-html-block) vult elk token hierboven in op basis van zijn Liquid-naam, plus deze:

| Token | Waarde | Terugvaltekst |
| --- | --- | --- |
| `company.name` | De bedrijfsnaam van de workspace | company |
| `date.today` | De verzenddatum | today |
| `date.tomorrow` | De dag na de verzenddatum | tomorrow |
| `principal.name`, `recipient.name` | Weergavenaam | Employee |
| `principal.email`, `recipient.email` | Zakelijk e-mailadres | email address |
| `principal.personalEmail`, `recipient.personalEmail` | Persoonlijk e-mailadres | personal email address |
| `principal.endDate`, `recipient.endDate` | Datum uit dienst | end date |
| `principal.city`, `principal.country`, `recipient.city`, `recipient.country` | Stad en land | city, country |
| `recipient.jobTitle` | De functietitel van de ontvanger | Job Title |
| `recipient.tenure` | Jaren sinds de diensttijddatum (of startdatum) van de ontvanger op het moment van verzenden, afgerond op hele jaren en weergegeven als `1 year` of `N years` | tenure |

Een Liquid-naam die Pyn niet kent blijft in de e-mail staan zoals getypt.

## Eigen tokens en tokens voor medewerkersvelden

- `custom.<column>`: een kolom uit de mailmergespreadsheet waarmee de persoon is ingeschreven, in camelCase (`Start Location` wordt `custom.startLocation`). Voeg hem in met **Insert widget**, **Custom Token**. Valt terug op de kolomnaam; een **Custom Token Block** zonder waarde toont je terugvaltekst, of niets. Zie [Inschrijven vanuit een spreadsheet](https://support.pyn.ai/nl/flows/automations/enroll-from-a-spreadsheet/).
- Tokens voor medewerkersvelden: elk veld op het medewerkersrecord, gekozen met **Insert token**, **Employee Field**, toegepast op de principal of de ontvanger, met een optionele terugvaltekst die je zelf typt. Zonder die tekst levert een ontbrekende waarde niets op.

## Opmaak

- Datums worden weergegeven in de taalinstelling van de ontvanger als weekdag, dag, maand en jaar, bijvoorbeeld "Thu, 22 Oct 2026". Verjaardagen als dag en maand.
- `date.today` en `date.tomorrow` komen uit het geplande tijdstip van de delivery; in een preview zonder verzendtijd tonen ze hun terugvaltekst.
- Diensttijd wordt afgerond op hele jaren, dus iemand die elf maanden in dienst is leest "1 year".
- Een token binnen een vetgedrukt of gekleurd stuk tekst behoudt die opmaak.

## Namen die Pyn niet meer invult

De volgende namen uit Pyn Classic worden geaccepteerd, maar leveren niets op: `date.nextBusinessDay`, elk `manager.*`-token (gebruik `principal.managerName`, `principal.managerPreferredName` en `principal.managerEmail`), `principal.homeAddress`, `principal.employeeNumber`, `principal.employmentType`, `principal.mobilePhone`, `principal.brand`, `principal.buddy.jobTitle`, `principal.buddy.location`, `principal.buddy.startDate`, `principal.buddy.startDate.dayAfter`, `principal.returnsFromLeaveOn`, de `recipient`-tegenhangers daarvan, en `recipient.startDate.dayAfter` en `recipient.startDate.nextBusinessDay`.

## Gerelateerd

- [Een bericht opmaken](https://support.pyn.ai/nl/flows/steps/format-a-message/) voor het invoegen van tokens, eigen tokens en medewerkersvelden.
- [Ontvangers en Cc kiezen](https://support.pyn.ai/nl/flows/steps/choose-recipients-and-cc/) voor wie op elke stap principal en ontvanger zijn.
- [Inschrijven vanuit een spreadsheet](https://support.pyn.ai/nl/flows/automations/enroll-from-a-spreadsheet/) voor kolommen met eigen tokens.
- [HiBob-veldmapping](https://support.pyn.ai/nl/integrations/hibob/field-mapping/) voor het Bob-veld achter elk token wanneer HiBob is gekoppeld.
