Kampagnen & Inhalte
API-getriggerte Kampagnen: eine gespeicherte Kampagne senden
POST /v1/campaigns/:id/trigger sendet eine gespeicherte Kampagne an benannte Personen mit eigenen Daten oder an Listen und Segmente.
POST /v1/campaigns/{id}/trigger sendet eine gespeicherte Kampagne aus Ihrem eigenen System: Eine Bestellung geht ein, ein Formular wird ausgefüllt, eine Automatisierung feuert. In der Nachricht stehen die Daten als {{ trigger.order_id }} (Liquid). Nötig ist ein API-Schlüssel mit dem Scope send oder ein Dashboard-Nutzer, der starten darf.
{
"recipients": [
{ "email": "ann@example.com", "data": { "order_id": "1001", "total": "99 EUR" } },
{ "contact_id": "…", "data": { "order_id": "1002" } }
],
"data": { "shop": "Acme" },
"idempotency_key": "order-1001"
}
Die Antwort ist 202 { campaign_id, accepted, unmatched, opted_out }. Pro Aufruf sind 1 bis 1.000 Empfänger möglich; Daten höchstens 50 Schlüssel und 8.000 Zeichen je Empfänger. Gemeinsame data gelten für alle, die eigenen Daten eines Empfängers haben Vorrang.
Stattdessen eine Zielgruppe ansprechen
Statt recipients nennen Sie list_ids und/oder segment_ids (bis zu 20 IDs; die des Kontos, sonst list_not_found oder segment_not_found). Die Zielgruppe wird beim Senden gelesen, die Antwort ist 202 { campaign_id, audience }.
Regeln
- Die gespeicherte Kampagne ist die Vorlage. Jeder Trigger kopiert sie in eine eigene Kampagne namens „<Name> (API trigger)“; die gespeicherte bleibt unberührt. Nur eine Kampagne mit Status
draft,sentoderactivelässt sich triggern (409campaign_not_triggerable). - Empfänger müssen bereits Kontakte sein. Unbekannte Personen kommen in
unmatchedzurück und werden nie angelegt. Abgemeldete Personen bleiben außen vor und werden inopted_outgezählt. - Alles, was ein Kampagnenversand durchsetzt, läuft weiter: Double-Opt-in, Suppression, Frequenzlimits und Ruhezeiten, Kontingent, Guthaben, Holdout, A/B, Rabattcode-Pools. Werte werden in E-Mails HTML-escaped.
idempotency_key: Derselbe Schlüssel bei derselben gespeicherten Kampagne antwortet200 { duplicate: true, campaign_id }und sendet nichts erneut, auch bei parallelen Aufrufen. Setzen Sie einen, wenn Ihr Aufrufer Wiederholungen macht.- Die erste E-Mail-Kampagne eines neuen Kontos wartet auf die Prüfung durch einen Menschen, daher antwortet ein Trigger mit
409 first_campaign_needs_review, bevor etwas kopiert wird. Senden Sie die Kampagne zuvor einmal aus dem Dashboard. - Ein fehlerhafter Body, die Kampagne eines anderen Kontos (404), ein Nur-Lese-Schlüssel (403) und kein Schlüssel (401) werden vor dem Versand abgelehnt.
Um den Kontakt zuerst anzulegen, rufen Sie POST /v1/contacts/upsert auf.
Eine Plattform. Jede Kundeninteraktion.
Ersetzen Sie Ihren Flickenteppich aus Messaging-APIs, CDP und Automatisierungstools durch eine Engagement-Plattform, die für Skalierung gebaut ist.
Keine Kreditkarte · EU-Datenhaltung · 99,99 % Uptime-SLA