Eine Kampagne über die API senden

Wenn Ihre Gestaltung aus einem anderen System stammt, beispielsweise einem CMS, das den Newsletter bereits generiert, können Sie die Kampagne vollständig über die API erstellen, befüllen und versenden. Sie müssen den Editor dann nicht öffnen.

Erstellen Sie die Kampagne

Die Absenderadresse muss in Laposta bestätigt sein, andernfalls erhalten Sie eine Fehlermeldung. Bei list_ids geben Sie die Listen und eventuelle Segmente an, die die Kampagne erhalten sollen.

curl

curl https://api.laposta.nl/v2/campaign \
  -u IHR_API_SCHLUESSEL: \
  -d type=regular \
  -d 'name=März-Newsletter' \
  -d 'subject=Der Newsletter von März' \
  -d 'from[name]=Beispiel GmbH' \
  -d from[email]=newsletter@example.net \
  -d reply_to=info@example.net \
  -d list_ids[]=BaImMu3JZA

PHP

$laposta = new Laposta('IHR_API_SCHLUESSEL');
$campagne = $laposta->campaignApi()->create([
    'type' => 'regular',
    'name' => 'März-Newsletter',
    'subject' => 'Der Newsletter von März',
    'from' => ['name' => 'Beispiel GmbH', 'email' => 'newsletter@example.net'],
    'reply_to' => 'info@example.net',
    'list_ids' => ['BaImMu3JZA'],
]);

Befüllen Sie die Kampagne mit HTML

Senden Sie das HTML mit oder geben Sie eine URL an, unter der Laposta den Code abruft. Wählen Sie eine der beiden Optionen. Wenn Sie beides mitsenden, verwendet Laposta das mitgesendete HTML.

curl

curl https://api.laposta.nl/v2/campaign/njhgaf61ye/content \
  -u IHR_API_SCHLUESSEL: \
  -d import_url=https://example.net/newsletter.html \
  -d inline_css=true

PHP

$laposta->campaignApi()->updateContent('njhgaf61ye', [
    'import_url' => 'https://example.net/newsletter.html',
    'inline_css' => true,
]);

In der Antwort befindet sich ein report mit Besonderheiten: ein fehlender Abmeldelink, entferntes JavaScript oder ein Bild, das nicht geladen werden konnte. Sie können die Kampagne auch mit diesen Hinweisen versenden, sollten sie aber zuerst überprüfen.

Senden Sie eine Test-E-Mail

Dies ist nur bei einer Kampagne möglich, die bereits Inhalt hat und noch nicht gesendet wurde.

curl

curl https://api.laposta.nl/v2/campaign/njhgaf61ye/action/testmail \
  -u IHR_API_SCHLUESSEL: \
  -d email=sie@example.net

PHP

$laposta->campaignApi()->sendTestMail('njhgaf61ye', 'sie@example.net');

Senden oder planen Sie die Kampagne

Der Versand erfolgt im Hintergrund: Sie erhalten sofort eine Antwort, während die Zustellung noch läuft. Zum Planen geben Sie einen Zeitpunkt in der Zukunft an.

curl

curl https://api.laposta.nl/v2/campaign/njhgaf61ye/action/schedule \
  -u IHR_API_SCHLUESSEL: \
  -d 'delivery_requested=2026-05-18 09:00:00'

PHP

$laposta->campaignApi()->schedule('njhgaf61ye', '2026-05-18 09:00:00');

Der Versand lässt sich nicht rückgängig machen. Ein zweiter Aufruf wird nicht blockiert und setzt die Zustellung erneut in Gang. Sorgen Sie dafür, dass Ihr eigener Code dies verhindert: Speichern Sie, dass Sie eine Kampagne bereits gesendet haben, und lassen Sie dieselbe Aktion bei einem wiederholten Aufruf oder einem Doppelklick nicht zweimal ausführen. Eine geplante Kampagne können Sie abbrechen, indem Sie diese löschen.

Eine Kampagne, die Sie im Drag-and-drop-Editor erstellt haben, können Sie nicht über die API befüllen oder auslesen. Sie erhalten dann die Meldung “Wrong campaign type”. Inhalt über die API funktioniert nur bei Kampagnen, die Sie selbst erstellt oder importiert haben.

Ergebnisse nach dem Versand abrufen

Sie können die Ergebnisse sofort nach dem Versand abrufen. Die Zahlen steigen danach weiter an, je mehr Empfänger die E-Mail öffnen und auf Links klicken.

Was	Wo
Anzahlen und Verhältnisse pro Kampagne	Ergebnisse einer Kampagne
Alle Kampagnen des Kontos	Alle Ergebnisse abrufen
Einzelne Ereignisse, wie Öffnungen und Klicks	Kampagnenverlauf abrufen