---
title: Vorlagen
description: Wiederverwendbarer E-Mail-Inhalt für Newsletter-Versände, verwaltet im Dashboard oder per API.
seo:
  title: E-Mail-Vorlagen
ai:
  exclude: true
---

Eine Vorlage ist wiederverwendbarer E-Mail-Inhalt: ein Betreff, HTML und ein optionaler Nur-Text-Teil. Halten Sie eine für Ihren nächsten [Newsletter-Versand](/docs/de/concepts/broadcasts) bereit. Im Dashboard können Sie unter **Vorlagen** eine im Block-Editor bauen oder das HTML selbst schreiben.

Wenn Sie im Editor des Newsletter-Versands eine Vorlage wählen, wird ihr Inhalt als Ausgangspunkt hineinkopiert. Spätere Änderungen an der Vorlage oder ihr Löschen ändern keine Newsletter-Versände, die Sie bereits erstellt haben.

## Platzhalter

Vorlagen können Werte pro Kontakt enthalten:

```html
<p>Hi {{{FIRST_NAME|there}}},</p>
```

- `{{{FIRST_NAME}}}`, `{{{LAST_NAME}}}` und `{{{EMAIL}}}` sind eingebaut. Jeder andere Name liest eine [Kontakteigenschaft](/docs/de/concepts/contacts) dieses Namens.
- `{{{NAME|fallback}}}` verwendet den Ersatztext, wenn der Kontakt keinen Wert hat.
- `{{{UNSUBSCRIBE_URL}}}` wird zum eigenen Abmeldelink jedes Empfängers. Siehe [Abmeldungen](/docs/de/concepts/unsubscribes).

## Block-Editor und HTML

- Eine im Block-Editor erstellte Vorlage lässt sich mit **Als HTML bearbeiten** auf HTML umstellen. Sie erhalten eine Kopie oder ändern sie an Ort und Stelle. Bis Sie speichern, stellt **Zurück zu Blöcken** die Blöcke wieder her.
- Eine Vorlage, die per API mit `html` angelegt wurde, öffnet sich im HTML-Modus, und Ihr HTML bleibt genau so erhalten, wie Sie es geschrieben haben. Ob Sie sie in Blöcke umwandeln, als Kopie oder an Ort und Stelle, entscheiden Sie, wobei tabellenbasierte Layouts eingeebnet werden.
- Im HTML-Modus folgt ein aus dem HTML erzeugter Nur-Text-Teil weiterhin Ihren Änderungen. Ein Nur-Text-Teil, den Sie über die API setzen, wird so gesendet, wie er gespeichert ist.

## Veröffentlichen und Versionen

Über die API ist jedes Speichern live: Jedes `POST /templates` und `PATCH /templates/{id}` veröffentlicht eine neue Version, daher lautet `status` immer `published`, und `POST /templates/{id}/publish` tut nichts und ist erfolgreich. Im Dashboard führt der Editor eine Arbeitskopie: Ihre Änderungen bleiben ein Entwurf, bis Sie **Veröffentlichen** wählen, wodurch eine neue Version veröffentlicht wird. Der **Versionsverlauf** listet jede veröffentlichte Version auf, und **Als Entwurf wiederherstellen** holt eine davon als Arbeitskopie zurück.

## API

Die SDKs rufen die Vorlagen-Endpunkte als `templates.*` auf.

```bash
curl -X POST https://api.billionsend.com/templates \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome",
    "subject": "Welcome to Acme",
    "html": "<p>Hi {{{FIRST_NAME|there}}}</p>",
    "alias": "welcome"
  }'
```

- `POST /templates` akzeptiert `name`, `html` und optional `subject`, `text` und `alias`.
- `GET /templates` listet Vorlagen auf, die neuesten zuerst. `GET /templates/{id}` liefert den vollständigen Inhalt.
- `PATCH /templates/{id}` ändert beliebige Felder. Ein leerer String oder `null` leert `subject` oder `text`. Das Schreiben von `html` oder `text` macht aus einer Block-Editor-Vorlage eine HTML-Vorlage.
- `DELETE /templates/{id}` löscht sie.
- `POST /templates/{id}/duplicate` erstellt eine Kopie mit dem Namen `<name> (copy)`, ohne den Alias.

Ein `alias` besteht aus Buchstaben, Ziffern, `.`, `_` und `-`, höchstens 100 Zeichen, und ist in Ihrem Team eindeutig. Jede der obigen Routen akzeptiert den Alias anstelle der ID. Ein bereits vergebener Alias antwortet mit `409`. Ein Alias, der wie eine UUID aussieht, ist nicht erlaubt.

## Nicht unterstützt

- `from`, `reply_to` und `variables` bei einer Vorlage antworten mit `422`. Legen Sie Absender und Reply-To im Newsletter-Versand fest und verwenden Sie Platzhalter direkt: Kontakteigenschaften müssen nicht deklariert werden.
- Eine Vorlagen-ID lässt sich nicht mit `POST /emails` oder `POST /broadcasts` senden. Senden Sie `html` oder `text` selbst. Die Vorlagenauswahl im Editor des Newsletter-Versands kopiert den Inhalt hinein.
