---
title: Newsletter-Versand
description: Eine E-Mail an viele Kontakte verfassen, planen und senden, mit Platzhaltern, Versandtempo und Abmeldelink pro Domain.
seo:
  title: Newsletter-Versand per E-Mail
ai:
  exclude: true
---

Ein Newsletter-Versand (Broadcast) ist eine E-Mail an viele Kontakte: an alle, an ein [Segment](/docs/de/concepts/segments) oder an ein [Thema](/docs/de/concepts/topics). Sie verfassen ihn im Dashboard unter **Newsletter-Versand** mit Platzhaltern pro Kontakt oder legen ihn per API an.

## Einen Newsletter-Versand senden

```ts
import { BillionSend } from "@billionsend/node";

const bs = new BillionSend(); // reads BILLIONSEND_API_KEY

const { data, error } = await bs.broadcasts.create({
  name: "November news",
  segment_id: "SEGMENT_ID",
  from: "Acme <news@mail.example.com>",
  subject: "What's new",
  html: "<p>Hi {{{FIRST_NAME|there}}},</p><p>...</p><p><a href=\"{{{UNSUBSCRIBE_URL}}}\">Unsubscribe</a></p>",
});

if (error) throw error;

await bs.broadcasts.send(data.id, { scheduled_at: "in 1 hour" });
```

Ohne `scheduled_at` wird sofort gesendet. Ein Newsletter-Versand braucht in `from` eine verifizierte Absenderdomain. Im Editor können Sie mit einer gespeicherten [Vorlage](/docs/de/concepts/templates) beginnen.

## Lebenszyklus

```
draft → scheduled → sending → sent
              ↘ canceled
              ↘ failed
```

- Ein neuer Newsletter-Versand ist ein **Entwurf**, und nur ein Entwurf lässt sich bearbeiten.
- `POST /broadcasts/{id}/send` sendet ihn sofort oder zu `scheduled_at`.
- `POST /broadcasts/{id}/cancel` bricht einen geplanten Newsletter-Versand ab, auch einen, der bereits läuft. Bereits gesendete E-Mails werden nicht zurückgeholt. `canceled_remaining` in der Antwort nennt, wie viele gestoppt wurden, und `sent_count` beim Lesen, wie viele hinausgegangen sind.
- Entwürfe und fehlgeschlagene Newsletter-Versände, die nichts gesendet haben, lassen sich löschen.
- In der API erscheinen `scheduled` und `sending` beide als `queued`. Ein Newsletter-Versand steht auf `queued` mit leerem `sent_at`, bis seine letzte E-Mail hinausgegangen ist.

## Wer ihn erhält

Jeder Empfänger wird geprüft, wenn der Newsletter-Versand hinausgeht. Ausgelassen werden:

- Kontakte, die für das gesamte Team `unsubscribed` sind, und Kontakte, die sich von der Absenderdomain des Newsletter-Versands abgemeldet haben;
- Kontakte, die das Thema des Newsletter-Versands abbestellt haben;
- Adressen auf der [Sperrliste](/docs/de/concepts/suppressions).

Die Empfängerzahl, die das Dashboard vor dem Senden anzeigt, lässt diese Kontakte bereits weg.

## Die Absenderdomain

Die Absenderdomain des Newsletter-Versands ist die in seiner `from`-Adresse, zurückgegeben als `domain_id`. Sie bestimmt:

- **Wessen Abmeldungen gelten.** Personen, die sich von dieser Domain abgemeldet haben, werden übersprungen. Siehe [Abmeldungen](/docs/de/concepts/unsubscribes).
- **Wie der Empfänger ihn sieht.** Der Abmeldelink öffnet die eigene [Abmeldeseite](/docs/de/concepts/unsubscribes) dieser Domain, auf deren eigener Subdomain, falls sie eine hat.
- **Welche Zielgruppe zulässig ist.** Ein Thema oder Segment, das an eine andere Domain gebunden ist, wird mit `422` abgelehnt, damit eine Marke nie die Zielgruppe einer anderen Marke anschreibt.

Eine Domain lässt sich nicht löschen, solange ein geplanter oder laufender Newsletter-Versand sie nutzt (`409`).

## Platzhalter und Abmeldelinks

- Werte pro Kontakt wie `{{{FIRST_NAME|there}}}` werden für jeden Empfänger eingesetzt. Siehe [Vorlagen](/docs/de/concepts/templates).
- Jede E-Mail eines Newsletter-Versands erhält `List-Unsubscribe`-Header für die Abmeldung mit einem Klick und einen gehosteten Abmeldelink. Um den Link im Text zu platzieren, schreiben Sie `{{{UNSUBSCRIBE_URL}}}`.

## Versandtempo

Ein Newsletter-Versand, der in die verfügbare Kapazität passt, geht sofort hinaus. Ein größerer geht in Wellen über die nächsten Tage hinaus. Transaktionsmails werden nie hinter einem Newsletter-Versand zurückgehalten: Sie werden vor den restlichen Empfängern eines Newsletter-Versands gesendet.

Der Aufruf zum Senden sagt Ihnen, was zu erwarten ist:

```json
{
  "id": "8c1f0b8e-…",
  "finishes_at": "2026-09-18T13:26:05Z",
  "estimated": true,
  "warning": { "code": "paced", "days": 3, "message": "…" }
}
```

- `finishes_at` ist der geschätzte Zeitpunkt, zu dem die letzte E-Mail hinausgeht. Es ist eine Schätzung, und andere Sendungen können ihn verschieben.
- `warning` erscheint, wenn der Versand mehr als eine Welle braucht: `paced`, wenn die Zielgruppe größer ist als die jetzt verfügbare Kapazität, `queued_behind`, wenn andere Sendungen vorgehen.
- Während des Versands enthält `GET /broadcasts/{id}` ein aktuelles `finishes_at` und `sent_count`.
- Eine Zielgruppe, die mehr als 24 Tage Kapazität bräuchte, wird mit `422 broadcast_too_large` abgelehnt. Teilen Sie sie in kleinere Segmente auf.

## Einen Newsletter-Versand duplizieren

`POST /broadcasts/{id}/duplicate` kopiert jeden Newsletter-Versand, auch einen gesendeten oder fehlgeschlagenen, in einen neuen Entwurf. Im Dashboard nutzen Sie **Duplizieren** im Menü des Newsletter-Versands.

- **Kopiert werden:** Segment, Thema, Absender, Betreff, `reply_to`, Vorschautext und Inhalt.
- **Nicht kopiert werden:** der Zeitplan, die Zählwerte und der Zustellfortschritt. Die Kopie ist ein normaler Entwurf.
- Der Name ist der des Originals, gefolgt von ` (copy)`.

## Wenn ein Newsletter-Versand fehlschlägt

Ein Newsletter-Versand endet als `failed`, wenn er angenommen wurde, aber nicht hinausgehen kann, oder wenn der Versand immer wieder fehlschlug. `GET /broadcasts/{id}` liefert dann `failure_reason` und `failed_at`. Bereits übergebene E-Mails bleiben gesendet, und die Inhaber des Teams erhalten einmal eine E-Mail.

| `failure_reason` | Bedeutung |
| --- | --- |
| `domain_missing` | Die Absenderdomain wurde gelöscht. |
| `sender_domain_mismatch` | `from` liegt nicht mehr auf der Domain, mit der der Newsletter-Versand geplant wurde. |
| `topic_other_domain` | Das Thema ist an eine andere Domain gebunden. |
| `segment_other_domain` | Das Segment ist an eine andere Domain gebunden. |
| `domain_unverified` | Die Absenderdomain blieb über einige Stunden an Wiederholungen unverifiziert. |
| `retries_exhausted` | Ein anderer Fehler trat immer wieder auf, bis die Wiederholungen aufgebraucht waren. |

Um die Zielgruppe trotzdem zu erreichen, duplizieren Sie den Newsletter-Versand, beheben die Ursache im neuen Entwurf und senden ihn.

## Wenn ein Newsletter-Versand abgelehnt wird

- `403 sending_paused`: Ihre Bounce- oder Beschwerderate ist zu hoch. Siehe [Sendelimits](/docs/de/concepts/sending-limits).
- `403 broadcasts_paused`: Newsletter-Versände sind pausiert, entweder plattformweit, bis sich die Raten erholen, oder für Ihr Team durch BillionSend. Transaktionsmails sind nicht betroffen.
- `403 inbox_send_policy`: Der Absender liegt auf Ihrer gemeinsamen Postfach-Domain, die keine Newsletter-Versände senden darf.

Erreicht ein Newsletter-Versand das Volumen Ihres Tarifs, wartet der Rest seiner Zielgruppe und geht hinaus, sobald wieder Platz ist. Siehe [Tarife und Limits](/docs/de/billing).

Alle Endpunkte für Newsletter-Versände finden Sie in der [API-Referenz](/docs/de/api-reference).
