---
title: Themen
description: "Abo-Kategorien: Empfänger bestellen eine Art von E-Mails ab und bleiben für den Rest angemeldet. Ein Thema lässt sich an eine Absenderdomain binden."
seo:
  title: E-Mail-Themen
ai:
  exclude: true
---

Ein Thema ist eine Kategorie von E-Mails, etwa „Produkt-Updates“, „Newsletter“ oder „Aktionen“. Empfänger können ein Thema verlassen und für den Rest angemeldet bleiben. Verwalten Sie Themen im Dashboard unter **Kontakte → Themen** oder über die API.

Jedes Thema hat eine `default_subscription`, die Sie beim Anlegen festlegen und später nicht mehr ändern können:

- `opt_in`: Jeder Kontakt ist angemeldet, solange er sich nicht abmeldet.
- `opt_out`: Ein Kontakt ist erst angemeldet, nachdem er sich selbst angemeldet hat.

Ein Thema hat außerdem eine `visibility`. Ein `public`-Thema steht auf der Abmeldeseite, ein `private`-Thema erscheint nur über seinen eigenen Link.

## Wie Themen wirken

- **Newsletter-Versände.** Ein Newsletter-Versand kann ein Thema ansprechen. Er geht an die Kontakte, die dieses Thema abonniert haben (durch eigene Wahl oder per Standard des Themas). Kontakte, die teamweit abgemeldet sind oder sich von der Absenderdomain abgemeldet haben, werden immer ausgelassen.
- **Einzelne E-Mails.** Senden Sie eine E-Mail mit einer `topic_id`, und sie respektiert dieses Thema. Hat jede `to`-Adresse das Thema abbestellt, liefert der Versand `422 all_recipients_suppressed`.
- **Abmeldeseite.** Die Seite listet die öffentlichen Themen auf, sodass ein Empfänger eines ausschalten oder alle Marketing-E-Mails dieser Domain abbestellen kann. E-Mails, die ohne `topic_id` und außerhalb eines Newsletter-Versands gesendet werden, sind nie betroffen. Siehe [Abmeldungen](/docs/de/concepts/unsubscribes).

Ein Thema, das ein Newsletter-Versand nutzt oder das eine noch wartende E-Mail genutzt hat, lässt sich nicht löschen: Der Aufruf liefert `409 conflict`, bis diese hinausgegangen oder abgebrochen sind.

```sh
curl -X POST "https://api.billionsend.com/topics" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "Product updates", "default_subscription": "opt_in" }'
```

Die Auswahl eines Kontakts setzen Sie mit `PATCH /contacts/{id}/topics` und übergeben Einträge wie `{ "id": "<topic-id>", "subscription": "opt_in" }`. `GET /contacts/{id}/topics` listet jedes Thema mit der `subscription` des Kontakts und einem Flag `explicit` auf (false, wenn es der Standard des Themas ist).

## Ein Thema pro Marke

Wenn jede Ihrer Domains eine eigene Marke ist, binden Sie ein Thema an die Domain, zu der es gehört, indem Sie `domain_id` setzen, beim Anlegen oder später mit `PATCH /topics/{id}`, oder indem Sie die Domain im Dashboard auswählen.

- Ein gebundenes Thema steht nur auf der Abmeldeseite dieser Domain. Die Seite keiner anderen Domain zeigt seinen Namen.
- Ein Versand mit dieser `topic_id` muss von dieser Domain kommen. Von jeder anderen liefern `POST /emails` und die Aufrufe für Newsletter-Versände `422`.
- Ein Thema ohne Domain steht auf der Seite jeder Domain und lässt sich von jeder Domain aus senden. `"domain_id": null` macht ein gebundenes Thema wieder teamweit.
- Eine Domain lässt sich nicht löschen, solange Themen an sie gebunden sind (`409`).

[Segmente](/docs/de/concepts/segments) lassen sich auf dieselbe Weise binden.

## API-Schlüssel, die auf eine Domain beschränkt sind

Ein auf eine Domain beschränkter API-Schlüssel kann nur Themen anlegen, die an diese Domain gebunden sind, und kann keines teamweit machen.
