Abonnenten verwalten

Ein Abonnent ist die Mitgliedschaft eines Kontakts in einer Kontaktliste. Diese Seite zeigt, wie Sie Abonnenten hinzufügen, ändern, ab- oder erneut anmelden und entfernen, und was jede Änderung für den zugehörigen Kontakt bedeutet.

Voraussetzungen

• Erstellen Sie zuerst die Kontaktliste. Siehe Kontaktlisten.
• Prüfen Sie, wie viel Platz die Kontaktliste noch hat. Das Limit zählt jeden Abonnenten, auch abgemeldete. Siehe Limits.
• Verwenden Sie für die API einen API-Schlüssel mit Full Access.

Abonnenten hinzufügen

curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": { "company": "Acme" }
  }'

{
  "object": "subscriber",
  "id": "sub_7Rt2vX9kLm3Qp",
  "audience_id": "aud_5hJ2kL8mNp4Qr",
  "contact_id": "con_2kq8Vt4xLm7Rz",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": { "company": "Acme" },
  "subscribed": true,
  "subscribed_at": "2026-10-01T09:30:00Z",
  "unsubscribed_at": null,
  "created_at": "2026-10-01T09:30:00Z",
  "updated_at": "2026-10-01T09:30:00Z"
}

Wenn die Person bereits auf der Kontaktliste steht

Was beim Hinzufügen einer Adresse passiert, die bereits auf der Kontaktliste steht, hängt von ihrem aktuellen Zustand ab:

Eine erneute Anmeldung über diesen Endpunkt sendet die Events subscriber.updated und subscriber.resubscribed und startet Automatisierungen mit dem Trigger Added to audience, genau wie ein neuer Abonnent.

Abonnenten bearbeiten

Öffnen Sie in der Abonnententabelle der Kontaktliste das Zeilenmenü und wählen Sie Edit. Sie können First name, Last name und den Schalter Subscribed ändern. Die E-Mail-Adresse ist hier schreibgeschützt.

Per API rufen Sie Abonnent aktualisieren auf. Geben Sie den Abonnenten über seine sub_-ID oder seine E-Mail-Adresse an und senden Sie beliebige der Felder email, first_name, last_name, custom_fields und subscribed:

curl https://api.emailit.com/v2/audiences/Newsletter/subscribers/ada@example.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "first_name": "Augusta", "subscribed": false }'

Namen, E-Mail-Adresse und eigene Felder gehören zum Kontakt, nicht zum Abonnenten. Wenn Sie sie hier ändern, wird der Kontakt überall aktualisiert, auch in seinen anderen Kontaktlisten. Nur subscribed gilt speziell für diese Kontaktliste.

Subscribed aktivieren oder deaktivieren

Das Kennzeichen Subscribed entscheidet, ob Kampagnen an diese Kontaktliste die Person erreichen. Deaktivieren lässt den Abonnenten auf der Liste, speichert unsubscribed_at und lässt die anderen Kontaktlisten des Kontakts unverändert. Erneutes Aktivieren setzt ein neues subscribed_at und leert unsubscribed_at.

Diese Änderungen senden das Event subscriber.updated. Sie erfassen keine Abmeldung bei einer Kampagne und erscheinen daher nicht im Tab Unsubscribes einer Kampagne. Wenn sich Empfänger selbst über den Link in einer Kampagne abmelden, verlassen sie alle Kontaktlisten auf einmal. Siehe Abmeldungen.

Abonnenten entfernen

Wenn Sie einen Abonnenten entfernen, wird die Mitgliedschaft gelöscht. Wählen Sie im Zeilenmenü auf der Seite der Kontaktliste Delete oder auf der Kontaktseite Remove from audience, oder rufen Sie Abonnent löschen auf.

Melden Sie Personen, die keine E-Mails mehr möchten, lieber ab, damit die Abmeldung dokumentiert bleibt. Entfernen Sie Abonnenten, die Sie versehentlich hinzugefügt haben oder nicht mehr behalten möchten. Um die Person vollständig zu löschen, löschen Sie den Kontakt; damit wird er aus allen Kontaktlisten entfernt.

Abonnenten auflisten und finden

Suchen Sie auf der Seite der Kontaktliste nach E-Mail-Adresse oder Namen und filtern Sie nach Email, First name, Last name, Subscribed oder Created.

Per API liefert Abonnenten auflisten alle Abonnenten, auch abgemeldete. Fügen Sie subscribed=true oder subscribed=false hinzu, um die Liste einzugrenzen, search, um nach E-Mail-Adresse oder Namen zu suchen, und page sowie limit (bis zu 100) zum Blättern:

curl "https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers?subscribed=true&limit=100&page=1" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Um eine einzelne Person nachzuschlagen, nutzen Sie Abonnent abrufen mit der sub_-ID oder der E-Mail-Adresse.

Siehe auch