---
title: "Token"
description: "Jedes Token, das du in eine Nachricht setzen kannst, womit Pyn es füllt, der Text, auf den es zurückfällt, wenn der Wert fehlt, und wie Datumsangaben und Namen formatiert werden."
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
---

Ein Token ist ein Platzhalter, den Pyn ersetzt, wenn eine Nachricht für einen Empfänger aufbereitet wird. Tippe `@` im Editor, um eines einzufügen; in einer Raw-HTML-E-Mail oder einem Raw HTML Block schreibst du es als Liquid-Tag, `{{ principal.preferredName }}`. `principal`-Token beziehen sich auf die eingeschriebene Person, `recipient`-Token auf die Person, die die Nachricht erhält; in einer Nachricht an die Mitarbeitenden selbst sind beide dieselbe Person.

Fehlt ein Wert, zeigt das Token seinen Fallback-Text aus den Tabellen unten, es sei denn, du legst am Token einen eigenen Fallback fest. Namen, Abteilungen und Jobtitel kommen aus dem Mitarbeitendendatensatz in [Directory](https://support.pyn.ai/de/directory/employees/).

## Token im Editor

| Token | Wert | Fallback |
| --- | --- | --- |
| `date.reference` | Das Referenzdatum des Enrollments | reference date |
| `principal.preferredName` | Rufname, sonst das erste Wort des Anzeigenamens | Employee |
| `principal.firstName` | Erstes Wort des Anzeigenamens (oder des rechtlichen Namens) | Employee |
| `principal.preferredFullName` | Rufname plus der Nachname aus dem Anzeigenamen | Employee |
| `principal.legalName` | Rechtlicher Name, sonst Anzeigename | Employee |
| `principal.jobTitle` | Jobtitel | Job Title |
| `principal.department` | Abteilung | department |
| `principal.location` | Standort | location |
| `principal.startDate` | Startdatum | start date |
| `principal.startDate.dayAfter` | Der Tag nach dem Startdatum | start date |
| `principal.startDate.nextBusinessDay` | Der nächste Werktag nach dem Startdatum | start date |
| `principal.tenure` | Volle Jahre seit dem Betriebszugehörigkeitsdatum (oder Startdatum) zum Sendezeitpunkt: „1 year“, „3 years“ | tenure |
| `principal.birthday` | Geburtstag als Tag und Monat, zum Beispiel „28 Jul“ | Birthday |
| `principal.nextBirthday` | Der nächste Geburtstag am oder nach dem Referenzdatum | next Birthday |
| `principal.nextAnniversary` | Das nächste Jubiläum des Startdatums am oder nach dem Referenzdatum | next Anniversary |
| `principal.managerName` | Anzeigename der Führungskraft | Manager |
| `principal.managerPreferredName` | Rufname der Führungskraft | Manager |
| `principal.managerEmail` | Geschäftliche E-Mail der Führungskraft | manager email |
| `principal.buddy.name` | Anzeigename des Buddys | Buddy |
| `principal.buddy.preferredName` | Rufname des Buddys | Buddy |
| `principal.buddy.preferredFullName` | Rufname und Nachname des Buddys | Buddy |
| `principal.buddy.email` | Geschäftliche E-Mail des Buddys | buddy email |
| `principal.buddy.startDate.nextBusinessDay` | Der Werktag nach dem Startdatum des Buddys | start date |
| `principal.hrbp.name` | Anzeigename des HR Business Partners | HRBP |
| `principal.hrbp.preferredName` | Rufname des HR Business Partners | HRBP |
| `principal.hrbp.preferredFullName` | Rufname und Nachname des HR Business Partners | HRBP |
| `principal.hrbp.email` | Geschäftliche E-Mail des HR Business Partners | HRBP email |
| `recipient.preferredName`, `recipient.firstName`, `recipient.preferredFullName`, `recipient.legalName` | Wie oben, für den Empfänger | Employee |
| `recipient.department`, `recipient.location` | Wie oben, für den Empfänger | department, location |
| `recipient.startDate` | Das Startdatum des Empfängers | start date |
| `recipient.birthday`, `recipient.nextBirthday`, `recipient.nextAnniversary` | Wie oben, für den Empfänger | Birthday, next Birthday, next Anniversary |
| `recipient.surveyLink` | Ein Link, der am Datensatz des Empfängers gespeichert ist; wird als Link gerendert, oder gar nicht | |

Der **Subject** einer E-Mail bietet eine kleinere Auswahl: Rufname, Geburtstag, nächster Geburtstag und nächstes Jubiläum der Hauptperson und des Empfängers. **Summary** und **Description** eines Jira-Tickets bieten zwölf `principal`-Token: `principal.department`, `principal.email`, `principal.employeeNumber`, `principal.jobTitle`, `principal.legalName`, `principal.location`, `principal.managerEmail`, `principal.managerName`, `principal.name`, `principal.preferredFullName`, `principal.preferredName` und `principal.startDate`.

## Token für Raw HTML

Eine Raw-HTML-E-Mail oder ein [Raw HTML Block](https://support.pyn.ai/de/flows/steps/format-a-message/#raw-html-block) löst jedes Token oben über seinen Liquid-Namen auf, dazu diese:

| Token | Wert | Fallback |
| --- | --- | --- |
| `company.name` | Der Firmenname des Workspace | company |
| `date.today` | Das Sendedatum | today |
| `date.tomorrow` | Der Tag nach dem Sendedatum | tomorrow |
| `principal.name`, `recipient.name` | Anzeigename | Employee |
| `principal.email`, `recipient.email` | Geschäftliche E-Mail | email address |
| `principal.personalEmail`, `recipient.personalEmail` | Private E-Mail | personal email address |
| `principal.endDate`, `recipient.endDate` | Austrittsdatum | end date |
| `principal.city`, `principal.country`, `recipient.city`, `recipient.country` | Stadt und Land | city, country |
| `recipient.jobTitle` | Der Jobtitel des Empfängers | Job Title |
| `recipient.tenure` | Jahre seit dem Betriebszugehörigkeitsdatum (oder Startdatum) des Empfängers zum Sendezeitpunkt, auf ganze Jahre gerundet und als `1 year` oder `N years` gerendert | tenure |

Einen Liquid-Namen, den Pyn nicht kennt, lässt es so in der E-Mail stehen, wie du ihn getippt hast.

## Eigene Token und Mitarbeitendenfelder

- `custom.<column>`: eine Spalte aus der Serienbrief-Tabelle, mit der die Person eingeschrieben wurde, in Camel Case benannt (aus `Start Location` wird `custom.startLocation`). Füge es mit **Insert widget**, **Custom Token** ein. Fällt auf den Spaltennamen zurück; ein **Custom Token Block** ohne Wert rendert deinen Fallback oder nichts. Siehe [Aus einer Tabelle einschreiben](https://support.pyn.ai/de/flows/automations/enroll-from-a-spreadsheet/).
- Mitarbeitendenfeld-Token: jedes Feld des Mitarbeitendendatensatzes, gewählt mit **Insert token**, **Employee Field**, angewendet auf die Hauptperson oder den Empfänger, mit einem optionalen Fallback, den du eintippst. Ohne ihn rendert ein fehlender Wert nichts.

## Formatierung

- Datumsangaben erscheinen in der Locale des Empfängers als Wochentag, Tag, Monat und Jahr, zum Beispiel „Thu, 22 Oct 2026“. Geburtstage erscheinen als Tag und Monat.
- `date.today` und `date.tomorrow` werden aus der geplanten Zeit der Zustellung genommen; in einer Vorschau ohne Sendezeit zeigen sie ihren Fallback.
- Die Betriebszugehörigkeit wird auf ganze Jahre gerundet, sodass jemand mit elf Monaten als „1 year“ erscheint.
- Ein Token innerhalb eines fetten oder farbigen Abschnitts behält diese Formatierung.

## Namen, die Pyn nicht mehr füllt

Die folgenden Namen aus Pyn Classic werden akzeptiert, rendern aber nichts: `date.nextBusinessDay`, jedes `manager.*`-Token (nutze `principal.managerName`, `principal.managerPreferredName` und `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`, die `recipient`-Entsprechungen davon sowie `recipient.startDate.dayAfter` und `recipient.startDate.nextBusinessDay`.

## Verwandte Seiten

- [Eine Nachricht formatieren](https://support.pyn.ai/de/flows/steps/format-a-message/) zum Einfügen von Token, eigenen Token und Mitarbeitendenfeldern.
- [Empfänger und Cc wählen](https://support.pyn.ai/de/flows/steps/choose-recipients-and-cc/) dafür, wer in jedem Schritt Hauptperson und Empfänger ist.
- [Aus einer Tabelle einschreiben](https://support.pyn.ai/de/flows/automations/enroll-from-a-spreadsheet/) für Spalten mit eigenen Token.
- [HiBob-Feldzuordnung](https://support.pyn.ai/de/integrations/hibob/field-mapping/) für das Bob-Feld hinter jedem Token, wenn HiBob verbunden ist.
