---
title: Abmeldungen und Marken
description: Abmeldungen werden pro Absenderdomain geführt, sodass jede Marke ihre eigene Liste, Abmeldeseite und Link-Domain hat.
seo:
  title: Abmeldelink pro Domain mit einem Klick
ai:
  exclude: true
---

Eine Abmeldung bedeutet „keine Marketing-E-Mails mehr“. BillionSend hält sie für die Absenderdomain fest, deren E-Mail den Link enthielt, sodass ein Team mit mehreren Marken deren Listen nie vermischt. Wer eine Marke verlässt, hört weiterhin von den anderen.

Transaktionsmails (E-Mails, die ohne [Thema](/docs/de/concepts/topics) und außerhalb eines [Newsletter-Versands](/docs/de/concepts/broadcasts) gesendet werden) sind von einer Abmeldung nie betroffen.

## Drei Geltungsbereiche

| Geltungsbereich | Wer setzt ihn | Was er stoppt |
| --- | --- | --- |
| Domain | Der Empfänger, mit dem Abmeldelink oder der Ein-Klick-Schaltfläche seines E-Mail-Programms | Marketing-E-Mails der Domain, die diese E-Mail gesendet hat |
| Gesamtes Team | Sie, indem Sie `unsubscribed` eines Kontakts auf `true` setzen (API, Dashboard oder CSV-Import) | Marketing-E-Mails jeder Domain Ihres Teams |
| Thema | Der Empfänger, auf der Abmeldeseite | E-Mails, die mit diesem [Thema](/docs/de/concepts/topics) gesendet werden |

Die eigene Abmeldung eines Empfängers ändert nie das Flag `unsubscribed` des Kontakts. Sie wird als Datensatz für die Domain gespeichert, mit der E-Mail-Adresse als Schlüssel, und übersteht deshalb das Löschen und erneute Importieren des Kontakts.

Newsletter-Versände und Themen-Sendungen überspringen einen Empfänger, der sich von der Absenderdomain, vom gesamten Team oder vom Thema abgemeldet hat. Eine einzelne E-Mail, die so gestoppt wird, endet als `suppressed` mit dem Grund `domain_unsubscribed`, `contact_unsubscribed` oder `topic_unsubscribed`.

Abmeldungen sind keine [Sperren](/docs/de/concepts/suppressions). Die Sperrliste enthält Adressen, die gebounct sind, sich beschwert haben oder die Sie blockiert haben, und sie stoppt jede E-Mail, auch Transaktionsmails. Eine Abmeldung stoppt nur Marketing-E-Mails.

## Die Abmeldeseite

Jede E-Mail eines Newsletter-Versands und jede Themen-E-Mail trägt `List-Unsubscribe`-Header für die Abmeldung mit einem Klick (RFC 8058) und einen Link zu einer gehosteten Abmeldeseite. Setzen Sie `{{{UNSUBSCRIBE_URL}}}` in einen Text, und er wird für jeden Empfänger zu demselben Link. Die Seite öffnet sich in der Browsersprache des Empfängers (vierzehn Sprachen, Englisch als Rückfall). Neben dem Abbestellen aller Marketing-E-Mails der Domain kann der Empfänger einzelne Themen ein- und ausschalten.

Ein Empfänger, der versehentlich geklickt hat, kann auf der Bestätigungsseite auf **Wieder anmelden** klicken. Das macht nur rückgängig, wovon ihn dieser Link abgemeldet hat. Ein Mail-Scanner, der den Link öffnet, meldet nie jemanden wieder an. Wenn Sie selbst `unsubscribed: true` setzen, hat die Seite keine Schaltfläche „Wieder anmelden“.

### Jede Domain hat ihr eigenes Aussehen

Die Seite sieht aus wie die Domain, die die E-Mail gesendet hat. Jede Domain kann Folgendes festlegen:

- einen Markennamen, ein Logo und den Eckenradius des Logos,
- Hintergrund-, Text- und Akzentfarben,
- den Text über der Schaltfläche und den Text, der nach dem Speichern der Auswahl angezeigt wird,
- eine Weiterleitungs-URL, die nach der Abmeldung geöffnet wird, statt der Meldung auf der Seite.

Öffnen Sie im Dashboard die Domain und nutzen Sie den Tab **Marke**, der das Ergebnis in einer Vorschau zeigt. Ein Feld, das Sie leer lassen, greift auf die **Marken-Standardwerte** des Teams (Einstellungen) zurück, danach auf das schlichte Aussehen von BillionSend. Die Seite zeigt nur, was zu dieser Domain gehört: Sie nennt nie eine andere Domain Ihres Teams und listet nur die Themen, die an diese Domain gebunden sind, sowie die Themen ohne Domain.

Über die API senden Sie die Felder in `unsubscribe_page` bei `PATCH /domains/{id}`. Ein `null` leert ein Feld. Das Logo wird im Dashboard hochgeladen und ist in der API nur lesbar.

```sh
curl -X PATCH "https://api.billionsend.com/domains/$DOMAIN_ID" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{
    "unsubscribe_page": {
      "brand_name": "Acme",
      "message": "Sorry to see you go. Unsubscribe from Acme emails?",
      "success_message": "You are unsubscribed from Acme.",
      "accent_color": "#0a7d5a",
      "logo_radius": "rounded"
    }
  }'
```

Ein Link, der nicht aus einer E-Mail stammt, etwa der von `POST /contacts/{id}/preferences-link`, öffnet die Standardseite des Teams, und eine Abmeldung dort meldet den Kontakt von jeder Domain ab.

### Ihre eigene Abmelde-Subdomain

Standardmäßig öffnen sich Links auf einem BillionSend-Host. Damit sie sich auf Ihrer eigenen Domain öffnen, geben Sie der Domain im Tab **Links** eine Abmelde-Subdomain oder setzen `unsubscribe_subdomain` bei `POST /domains` oder `PATCH /domains/{id}` (ein Label wie `unsubscribe` für `unsubscribe.yourdomain.com`; `null` löscht es). Sie funktioniert wie die Tracking-Subdomain, siehe [Domains](/docs/de/concepts/domains).

1. Legen Sie den CNAME an, den der Tab **DNS** der Domain anzeigt, mit Ziel `cname.billiondns.com`, als Nur-DNS-Eintrag (graue Wolke bei Cloudflare).
2. Das Zertifikat wird automatisch ausgestellt, sobald der CNAME auflöst, meist innerhalb von Minuten. `unsubscribe_status` wechselt von `pending` zu `active`, und `unsubscribe_error` nennt den Grund, wenn das nicht klappt.
3. Neue E-Mails verwenden dann Ihren Host im Link und im `List-Unsubscribe`-Header. Solange er nicht aktiv ist und nach einem Ergebnis `failed` (72 Stunden ohne Aktivierung), wird der gemeinsame Host verwendet.

Ein bereits gesendeter Link behält den Host, mit dem er gesendet wurde, und funktioniert daher nicht mehr, wenn Sie den CNAME später entfernen. Eine Subdomain von Ihnen öffnet nur die Links ihrer eigenen Domain; jeder andere Link antwortet mit `404`.

Sie können für Tracking und Abmeldung ein Label nutzen, getrennte Namen sind aber sicherer: Werbeblocker blockieren Tracking-Hosts, und ein gemeinsamer Name würde den Abmeldelink mit herunterziehen.

## Abmeldungen lesen und ändern

`GET /contacts/{id}` liefert `unsubscribed` (das teamweite Flag) und `unsubscribed_domains`. Im Dashboard listet die Seite eines Kontakts beides auf und lässt Sie die Abmeldung von einer Domain entfernen. Der Tab **Abmeldungen** unter Zielgruppe listet jeden Datensatz auf.

```sh
# List, newest first. domain_id narrows to one domain.
curl "https://api.billionsend.com/unsubscribes?domain_id=$DOMAIN_ID" \
  -H "Authorization: Bearer bs_..."

# Record an opt-out from one domain (leave domain_id out for every domain)
curl -X POST "https://api.billionsend.com/unsubscribes" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "ada@example.org", "domain_id": "'"$DOMAIN_ID"'" }'

# Remove one record
curl -X DELETE "https://api.billionsend.com/unsubscribes/$UNSUBSCRIBE_ID" \
  -H "Authorization: Bearer bs_..."
```

Ein Datensatz, bei dem `domain_id` und `domain` beide `null` sind, meldet die Adresse von jeder Domain ab. Das `POST` ist idempotent: Ein bestehender Datensatz kommt unverändert zurück. Dieselben Aufrufe gibt es als MCP-Tools `list_unsubscribes`, `add_unsubscribe` und `delete_unsubscribe`.

Was was aufhebt:

- `PATCH /contacts/{id}` mit `unsubscribed: false` hebt nur die teamweite Abmeldung auf. Abmeldungen von bestimmten Domains bleiben bestehen.
- `DELETE /unsubscribes/{id}` entfernt genau diesen einen Datensatz.

Wenn Sie eine Domain löschen und unter demselben Namen erneut hinzufügen, gelten die Abmeldungen ihrer Empfänger wieder.

### Wer sie ändern darf

Inhaber, Admins und Marketing-Mitglieder sowie API-Schlüssel mit vollem Zugriff können Abmeldungen erfassen. Nur Inhaber und Admins können eine zurücknehmen. Siehe [Teamrollen](/docs/de/team-roles).

Ein auf eine Domain beschränkter API-Schlüssel verwaltet nur die Abmeldungen dieser Domain: Andere Domains liefern `403 restricted_api_key`.

## Eine Liste aus CSV importieren

Um eine Abmeldeliste eines anderen Anbieters zu übernehmen, öffnen Sie im Dashboard **Kontakte → Abmeldungen** und wählen **CSV importieren**.

```csv
email,domain
ada@example.com,
grace@example.com,news.example.org
alan@example.com,*
```

- `email` ist erforderlich. `domain` ist optional. Eine Kopfzeile ist ebenfalls optional.
- `domain` ist eine Ihrer Domains und beschränkt die Abmeldung auf E-Mails von ihr. `*` steht für jede Domain. Eine leere Zelle verwendet die **Standarddomain**, die Sie im Dialog wählen.
- Eine Zeile mit unbekannter Domain oder ungültiger Adresse wird übersprungen.

Der Dialog zeigt, wie viele Abmeldungen hinzugefügt wurden, wie viele bereits existierten und warum Zeilen übersprungen wurden. Dieselbe Datei zweimal zu importieren ist unbedenklich.

## Ereignisse

Die Abmeldung eines Empfängers löst `contact.unsubscribed` aus, mit `source` gleich `hosted_page` oder `one_click`, dazu `domain_id` und `domain_name` (beide `null` bei einer teamweiten Abmeldung). Das Zurücknehmen löst `contact.resubscribed` aus. Siehe [Webhooks](/docs/de/concepts/webhooks).

## Limits

| | Free | Starter, Pro, Scale |
| --- | --- | --- |
| Aussehen der Abmeldeseite (Logo, Farben, Schrift, Logo-Eckenradius) | Standardaussehen | Ihr eigenes Aussehen pro Domain |
| Eigene Abmelde-Subdomain | Nein (gemeinsamer Host) | Ja |
| „Powered by BillionSend“ auf der Seite | Angezeigt | Ausgeblendet |

Bei Free liefert das Setzen einer Subdomain `403 plan_limit_reached`. Sie können ein Seitenaussehen speichern, aber Empfänger sehen das Standardaussehen, bis Sie upgraden. Nach einem Downgrade bleiben gespeicherte Aussehen erhalten und gelten wieder, wenn Sie upgraden, und bereits gesetzte Subdomains funktionieren weiter.
