UTM-Werte, die verwendet werden, wenn utm_tracking aktiviert ist. Jeder Schlüssel setzt einen utm_-Parameter:

• source (Standardwert emailit), medium (Standardwert email) und campaign (Standardwert {campaign_name}).
• content, term und id, die standardmäßig nicht hinzugefügt werden.

Werte sind Text mit bis zu 191 Zeichen und können die Tokens {campaign_name} (der Kampagnenname in Kleinbuchstaben, mit Bindestrichen), {campaign_id}, {subject}, {variant} (der Name der A/B-Test-Version) und {send_date} (YYYY-MM-DD) enthalten. Unbekannte Schlüssel und Tokens geben 422 zurück. Schlüssel, die Sie nicht setzen, behalten ihre Standardwerte; null oder {} setzt alle zurück.

Ein A/B-Test mit 2 bis 5 Versionen. Ein zufälliger Anteil der Empfänger wird gleichmäßig auf die Versionen aufgeteilt. Nach duration_hours erhalten die übrigen Empfänger die Version mit dem besten Ergebnis. Während der Test läuft, hat die Kampagne den Status testing. A/B-Tests senden mit der Strategie immediate, sofort oder zu einem geplanten Zeitpunkt.

• enabled (boolean, Standardwert true): false deaktiviert den Test.
• winner_metric (string, Standardwert opened): opened, clicked, orders (zugeordnete Bestellungen pro gesendeter E-Mail) oder revenue (zugeordneter Umsatz pro gesendeter E-Mail). orders und revenue gehören zu Commerce, das in der Alpha ist: Andere Anfragen geben 403 mit error: "commerce_alpha" zurück.
• test_size_percent (integer, Standardwert 20): Anteil der Empfänger im Test, von 10 bis 100. Bei 100 sind alle im Test, und es wird keine Gewinnerversion gesendet.
• duration_hours (integer, Standardwert 4): wie lange der Test läuft, bevor die Gewinnerversion gesendet wird, von 1 bis 168.
• variants (object[], erforderlich): 2 bis 5 Versionen. Jede kann name (bis zu 100 Zeichen, Standardwerte A, B, C und so weiter), subject, preview_text, from_name, from_email, reply_to, html und text festlegen. Felder, die eine Version weglässt, stammen aus der Kampagne. Mindestens eine Version muss einen Betreff, einen Vorschautext, einen Absendernamen, eine Absenderadresse oder einen Inhalt festlegen.

Was der letzte Versand bewirkt hat, oder null, bevor die Kampagne gesendet wird:

• recipients: Kontakte in den Kontaktlisten und Segmenten, einmal pro Adresse.
• suppressed: übersprungen, weil die Adresse gesperrt ist.
• smart_sending_skipped: durch smart_sending_hours übersprungen.
• unengaged_skipped: durch exclude_unengaged übersprungen.
• sent: Kontakte, denen die Kampagne gesendet wurde. Bei einem A/B-Test nur die Testgruppe.
• batches: Anzahl der Versand-Batches.
• completes_at: wie send_completes_at.

Der A/B-Test. Ohne Test: { "enabled": false, "variants": [] }. Mit Test: enabled, winner_metric, test_size_percent, duration_hours und variants. Jede Version hat id (cvr_…), name, subject, preview_text, from_name, from_email, reply_to, html, text (null, wenn die Version den Wert der Kampagne verwendet) und is_winner. Siehe Kampagne erstellen.

Der A/B-Test mit den Feldern, die unter Kampagne erstellen beschrieben sind. Wenn Sie ab_test senden, werden der Test und seine Versionen ersetzt. Um die ID einer Version und damit ihre Ergebnisse zu behalten, geben Sie ihre id (cvr_…) in der Version an. null oder "enabled": false deaktiviert den Test und löscht die Versionen.

Die Kontaktlisten und Segmente, an die sich die Kampagne richtet, bis zu 100 Einträge. Ersetzt die aktuelle Liste. Geben Sie mindestens einen Eintrag mit exclude auf false an. Jeder Eintrag hat entweder audience_id oder segment_id, nicht beides:

• audience_id (String): eine Kontaktlisten-ID (aud_…) in diesem Workspace.
• segment_id (String): eine Segment-ID (seg_…) in diesem Workspace. Segmente sind in der Alpha: Nur das Emailit-Team kann ein Segment hinzufügen, andere Anfragen geben 403 mit error: "segments_alpha" zurück. Segmente, die die Kampagne bereits hat, können bleiben.
• exclude (Boolean, Standardwert false): true lässt die Abonnenten der Kontaktliste oder die Kontakte des Segments aus, auch wenn sie zugleich in einem eingeschlossenen Eintrag sind.

Doppelte Einträge werden ignoriert. Beim Versand sendet Emailit jedem Kontakt genau eine E-Mail, wenn er bei einer eingeschlossenen Kontaktliste angemeldet ist oder einem eingeschlossenen Segment entspricht, in keinem ausgeschlossenen Eintrag ist, nicht global abgemeldet ist, bei mindestens einer Kontaktliste angemeldet ist und nicht gesperrt ist. Segmente werden beim Versand ausgewertet. Existiert eine ausgeschlossene Kontaktliste oder ein ausgeschlossenes Segment bis dahin nicht mehr, wird die Kampagne nicht gesendet.

all (Standardwert) verlangt, dass alle Filter zutreffen. or trifft zu, wenn ein beliebiger Filter passt. Siehe Filtern und Sortieren.

Sortierschlüssel für diese Liste. Siehe die Sortierschlüssel unten.

asc oder desc.

Sendezeitpunkt. Akzeptiert ISO 8601 (2026-10-08T09:00:00Z), einen Unix-Zeitstempel in Sekunden oder natürliche Sprache wie tomorrow at 9am (in UTC interpretiert). Der Zeitpunkt muss in der Zukunft liegen und die Kampagne muss ein Entwurf (draft) sein.

Lassen Sie den Parameter weg, um sofort zu senden. Um eine geplante Kampagne früher zu senden, rufen Sie diesen Endpunkt ohne scheduled_at auf.

Wie der Versand zeitlich verteilt wird. Standardmäßig gilt die in der Kampagne gespeicherte Strategie, sonst immediate. Die Strategie und ihre Optionen werden in der Kampagne gespeichert. Siehe Versandoptionen.

• immediate: alle auf einmal, sofort oder zu scheduled_at.
• throttled: gleichmäßig mit per_hour E-Mails pro Stunde, ab sofort oder ab scheduled_at.
• local_time: eine Uhrzeit in der Zeitzone jedes Kontakts. scheduled_at wird ignoriert.
• smart_time: jeder Kontakt zu der Stunde, in der er üblicherweise öffnet oder klickt, innerhalb eines Zeitfensters ab dem Start.

Kampagnen mit einem A/B-Test senden nur mit immediate.

Optionen der Strategie. Standardmäßig gelten die in der Kampagne gespeicherten Optionen.

• throttled: per_hour (integer, erforderlich), von 100 bis 1.000.000 E-Mails pro Stunde.
• local_time: local_time (string, erforderlich), die Uhrzeit im Format YYYY-MM-DDTHH:mm, zum Beispiel 2026-10-08T09:00, und timezone (string, Standardwert UTC), die IANA-Zeitzone für Kontakte, deren Zeitzone nicht bekannt ist. Die Zeitzonen der Kontakte stammen aus dem Tracking-Skript. Der Versand beginnt, wenn die früheste Zeitzone (UTC+14) die Uhrzeit erreicht; Kontakte in Zeitzonen, in denen sie bereits vorbei ist, erhalten die E-Mail sofort. Bis dahin ist die Kampagne scheduled, sie muss daher ein Entwurf sein. Gibt 422 zurück, wenn die Uhrzeit in allen Zeitzonen vorbei ist.
• smart_time: window_hours (integer, Standardwert 24), von 1 bis 48. Jeder Kontakt erhält die E-Mail zu der Tagesstunde (UTC), in der er in den letzten 90 Tagen am häufigsten geöffnet oder geklickt hat, wobei ein Klick dreimal so viel zählt wie eine Öffnung, sofern diese Stunde in das Zeitfenster fällt. Kontakte ohne diese Historie erhalten sie zu der Stunde, die unter den übrigen Empfängern am häufigsten ist. Kontakte ohne beides oder deren Stunde außerhalb des Zeitfensters liegt, erhalten sie zum Start.

timezone wird bei jeder Strategie akzeptiert und muss eine gültige IANA-Zeitzone sein, verwendet wird es aber nur von local_time.

Die Kampagnen-ID (cmp_...) oder der Name der Kampagne. Namen mit Leerzeichen oder Sonderzeichen müssen Sie URL-kodieren.

Nur E-Mails zählen, die zu diesem Zeitpunkt oder danach erstellt wurden, als Datum oder Datum mit Uhrzeit im Format ISO 8601.

Nur E-Mails zählen, die zu diesem Zeitpunkt oder davor erstellt wurden.

Nur E-Mails zählen, die aktuell diesen Status haben: accepted, scheduled, delivered, loaded, clicked, attempted, bounced, failed, rejected, suppressed oder complained. Andere Werte werden ignoriert.

Immer campaign_stats.

Die Kampagnen-ID (cmp_...).

Für die Kampagne erstellte E-Mails. sent_percent ist 100 oder 0, solange noch nichts gesendet wurde.

Die E-Mails mit dem Status delivered, loaded oder clicked.

Die E-Mails, die mindestens einmal geöffnet wurden.

Die E-Mails mit mindestens einem erfassten Klick.

clicked als Prozentsatz von opened.

Die E-Mails mit dem Status bounced, suppressed, complained oder attempted (wartet auf eine Wiederholung). Zu jedem gibt es auch ein Feld _percent.

Die E-Mails, die noch accepted oder scheduled sind.

Abmeldungen über die E-Mails der Kampagne.

Ergebnisse pro Postfachanbieter der Empfänger, für Anbieter mit mindestens einer E-Mail. key ist gmail, outlook.com, live.com, hotmail.com, yahoo, icloud oder other, und label ist der Anzeigename des Anbieters. Jeder Eintrag hat sent, delivered, opened, clicked und bounced mit den zugehörigen Feldern _percent. sent_percent ist der Anteil des Anbieters an allen E-Mails; die übrigen Prozentwerte beziehen sich auf sent des Anbieters.

Nur für das Emailit-Team, solange Commerce in der Alpha ist: Andere Anfragen erhalten dieses Feld nicht, und in den variants ihrer A/B-Tests fehlen orders, revenue und revenue_per_recipient. Bestellungen, die der Kampagne zugeordnet sind. Der Umsatz ist die Bestellsumme abzüglich Rückerstattungen, und stornierte Bestellungen zählen nicht. Beträge in verschiedenen Währungen werden nicht addiert: Die Hauptwährung ist die Währung mit dem meisten Umsatz.

• currency (string oder null): die Hauptwährung.

• revenue (number): Umsatz in der Hauptwährung.

• orders (integer): zugeordnete Bestellungen in allen Währungen.

• buyers (integer): verschiedene Käufer in allen Währungen. Ein Käufer, der in zwei Währungen bezahlt hat, zählt einmal.

• average_order_value (number): in der Hauptwährung.

• conversion_percent (number): buyers als Prozentsatz der zugestellten E-Mails der Kampagne.

• revenue_per_recipient (number): revenue geteilt durch die zugestellten E-Mails der Kampagne.

• by_currency (object[]): currency, orders, revenue, buyers und average_order_value für jede Währung, die mit dem höchsten Umsatz zuerst.

Nur bei Kampagnen mit einem A/B-Test.

• winner_metric (string): opened, clicked, orders oder revenue.

• leader_variant_id (string oder null): die Version mit der bisher besten Quote, also Öffnungen, Klicks oder Bestellungen pro gesendeter E-Mail oder Umsatz pro gesendeter E-Mail.

• win_probability (number oder null): die Wahrscheinlichkeit in Prozent, dass die führende Version die zweitplatzierte tatsächlich schlägt.

• significance (string): significant (90 % oder mehr, mit mindestens 50 E-Mails pro Version), promising (75 % oder mehr, gleiches Minimum), not_significant (unter 75 % bei mindestens 1.800 E-Mails pro Version) oder inconclusive. Bei revenue basiert die Wahrscheinlichkeit auf Bestellungen.

• variants (object[]): pro Version variant_id, name, subject, is_winner, sent, delivered, opened, opened_percent, clicked, clicked_percent, orders, revenue und revenue_per_recipient. Sobald die Gewinnerversion an die übrigen Empfänger gesendet ist, enthalten die Zahlen der Gewinnerversion auch diese E-Mails.