Anleitung
Abonnenten verwalten
Fügen Sie Personen zu einer Kontaktliste hinzu oder importieren Sie sie, bearbeiten Sie sie, aktivieren oder deaktivieren Sie ihr Kennzeichen Subscribed, entfernen Sie sie und erledigen Sie all das auch gesammelt, in der Weboberfläche oder mit der API für Abonnenten.
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
-
Kontaktliste öffnen. Öffnen Sie Email MarketingAudiences und wählen Sie die Kontaktliste.
-
Person hinzufügen. Wählen Sie Add subscriber und geben Sie Email sowie optional First name und Last name ein.
-
Speichern. Wählen Sie Add. Gibt es für die Adresse noch keinen Kontakt, legt Emailit einen an.
Hat die Kontaktliste Double-Opt-in aktiviert, ist Ask them to confirm by email first (double opt-in) angehakt: Die Person erhält die Double-Opt-in-E-Mail und wird hinzugefügt, wenn sie auf den Link darin klickt. Entfernen Sie das Häkchen, um sie sofort hinzuzufügen. Hat die Kontaktliste eine Anmeldebestätigung, sendet Send the confirmation email sie an die Person, die Sie hinzufügen.
Sie können auch bestehende Kontakte unter Email MarketingContacts hinzufügen: Öffnen Sie einen Kontakt und wählen Sie Add to audience, oder wählen Sie mehrere Kontakte aus und nutzen Sie Actions > Add to audience. Um viele Personen auf einmal hinzuzufügen, importieren Sie eine Datei.
Rufen Sie Abonnent hinzufügen mit der ID oder dem Namen der Kontaktliste auf:
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"
}Nur email ist erforderlich. Wenn Sie für einen bestehenden Kontakt first_name, last_name oder custom_fields übergeben, überschreiben diese die Werte des Kontakts, und custom_fields ersetzt das gesamte Objekt.
Übergeben Sie "double_opt_in": true, um die E-Mail für das Double-Opt-in der Kontaktliste zu senden, statt die Person sofort hinzuzufügen; die Antwort ist dann 202 mit "status": "pending". Übergeben Sie "send_confirmation_email": true, um nach dem Hinzufügen die Anmeldebestätigung der Kontaktliste zu senden.
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:
| Aktueller Zustand | Ergebnis | API-Antwort |
|---|---|---|
| Nicht auf der Kontaktliste | Ein neuer Abonnent wird mit aktiviertem Subscribed angelegt. | 201 |
| Auf der Kontaktliste, Subscribed aktiviert | Nichts ändert sich. Die Weboberfläche zeigt „Contact is already subscribed to this audience“. | 409 mit dem Abonnenten in existing |
| Auf der Kontaktliste, abgemeldet | Der Abonnent wird erneut angemeldet: Subscribed wird aktiviert, subscribed_at wird auf jetzt gesetzt und unsubscribed_at geleert. |
200 |
| Die Kontaktliste ist voll | Nichts wird hinzugefügt. | 422 mit usage |
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 importieren
Um viele Personen auf einmal hinzuzufügen, öffnen Sie die Kontaktliste und wählen Sie Import. Laden Sie eine CSV- oder Excel-Datei mit bis zu 2.500 Zeilen hoch, ordnen Sie ihre Spalten Kontaktfeldern zu, prüfen Sie die Vorschau und wählen Sie Import. Alle Personen in der Datei werden zu dieser Kontaktliste hinzugefügt; Kontakte, die noch nicht existieren, werden angelegt.
Importe laufen im Hintergrund, daher erscheinen neue Abonnenten erst nach einem Moment. Sie fragen kein Double-Opt-in an und senden weder die Anmeldebestätigung noch Abonnenten-Events. Um in mehrere Kontaktlisten gleichzeitig zu importieren, nutzen Sie den Import auf der Seite Contacts. Siehe Kontakte importieren und exportieren.
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.
| Wo | Abmelden | Erneut anmelden |
|---|---|---|
| Seite der Kontaktliste | Edit, dann Subscribed deaktivieren | Edit, dann Subscribed aktivieren |
| Kontaktseite | Unsubscribe im Zeilenmenü der Kontaktliste | Resubscribe im Zeilenmenü |
| API | Abonnent aktualisieren mit "subscribed": false |
Aktualisieren mit "subscribed": true oder die Adresse erneut hinzufügen |
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.
| Abmelden | Entfernen | |
|---|---|---|
| Person bleibt auf der Liste | Ja, mit deaktiviertem Subscribed | Nein |
| Zählt zum Limit der Kontaktliste | Ja | Nein |
| Kontakt bleibt erhalten | Ja | Ja |
| Event | subscriber.updated |
subscriber.deleted, das Automatisierungen mit dem Trigger Removed from audience startet |
| Erneutes Hinzufügen der Adresse | Meldet den bestehenden Abonnenten erneut an | Legt einen neuen Abonnenten an |
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.
Massenaktionen
Wählen Sie Abonnenten über die Checkboxen aus und nutzen Sie dann Actions:
- Subscribe aktiviert Subscribed.
- Unsubscribe deaktiviert Subscribed und lässt die Personen auf der Liste.
- Remove from audience löscht ihre Mitgliedschaften. Die Kontakte bleiben erhalten.
Um mehr als eine Seite zu bearbeiten, wählen Sie mit der Checkbox in der Kopfzeile die ganze Seite aus und dann Select all matching subscribers. Damit wählen Sie alle Personen, die der aktuellen Ansicht (All, Engaged oder Unengaged) und der Suche entsprechen, bis zu 10.000 Personen. Jede Änderung sendet dieselben Events wie eine Änderung des Abonnenten von Hand.
Per API rufen Sie Abonnenten gesammelt aktualisieren mit bis zu 1.000 Abonnenten-IDs auf oder mit "all_matching": true und optional einem Filter engagement oder subscribed.
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, Subscribed at, Last opened or clicked oder Added. Wählen Sie eine Spaltenüberschrift, um danach zu sortieren. Last opened or clicked zeigt die letzte Öffnung oder den letzten Klick des Kontakts bei einer beliebigen E-Mail aus Ihrem Workspace, und die Ansichten Engaged und Unengaged teilen die angemeldeten Personen nach der Regel für inaktive Kontakte der Kontaktliste auf.
Per API liefert Abonnenten auflisten alle Abonnenten, auch abgemeldete. Fügen Sie subscribed=true oder subscribed=false hinzu, um die Liste einzugrenzen, engagement=engaged oder engagement=unengaged, um nach Engagement aufzuteilen, search, um nach E-Mail-Adresse oder Namen zu suchen, order und direction zum Sortieren 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.