Tracking · Email API

Tracken Sie Ihre API-E-Mails

Ergänzen Sie den Versand, den Sie schon machen, um ein paar Felder. Sie erhalten Öffnungen, Klicks, eine One-Click-Abmeldung und jeden Empfänger als Kontakt gespeichert — ohne vorher etwas anzulegen.

POST mail.sendcorex.com/v3.0/send

Die Felder

Alle optional. Ergänzen Sie sie neben to, from, subject und body — nutzen Sie nur die, die Sie brauchen.

trackstring

Der Name, unter dem diese E-Mails in Analytics gruppiert werden.

  • Wird beim ersten Versand angelegt — vorher nichts einzurichten.
  • Gleicher Name, gleicher Track: Groß-/Kleinschreibung und zusätzliche Leerzeichen spielen keine Rolle ("Welcome Email" = "welcome email").
  • Bis zu 100 Zeichen. Verwenden Sie einen pro E-Mail-Art, etwa "Welcome" oder "Invoice".
"track": "Weekly Newsletter"
track_opensboolean

Zählt, wer die E-Mail geöffnet hat.

  • Fügt dem HTML ein unsichtbares Pixel hinzu.
  • Automatische Öffnungen (Apple-Mail-Datenschutz, Sicherheitsscanner) werden getrennt gezählt — sie blähen Ihre Öffnungsrate nie auf.
  • Ohne track wird die Öffnung trotzdem am Kontakt gespeichert, nur nicht in Analytics gruppiert.
"track_opens": true
track_clicksboolean

Zählt, wer welchen Link angeklickt hat.

  • Links im Body laufen über Sendcorex und leiten sofort auf Ihre Seite weiter.
  • Sie sehen die Top-Links und welche Kontakte sie angeklickt haben.
"track_clicks": true
unsubscribeboolean

Nutzen Sie den Abmeldelink von Sendcorex.

  • Fügen Sie [unsubscribe] in den Body ein (oder [unsubscribe_url], [unsub_url], [opt_out_url]). Jeder Empfänger erhält einen persönlichen Link.
  • Fügt außerdem die von Gmail und Yahoo verlangten Header List-Unsubscribe und One-Click hinzu. Ein selbst gesendeter List-Unsubscribe wird ignoriert.
  • Wer sich abmeldet, erhält keine E-Mails mehr von Ihrem gesamten Konto: Kampagnen, API und SMTP.
  • true ohne den Platzhalter liefert MISSING_UNSUBSCRIBE_PLACEHOLDER und es wird nichts gesendet.
"unsubscribe": true
contact_liststring

Die Kontaktliste, in der die Empfänger gespeichert werden.

  • Wird angelegt, falls sie noch nicht existiert. Ohne sie landen die Empfänger in "API Contacts".
  • Empfänger werden nur gespeichert, wenn Sie track, track_opens, track_clicks, unsubscribe oder contact_list verwenden. Ein einfacher Versand speichert nichts.
  • Wer schon in Ihren Kontakten ist, wird aktualisiert, nie dupliziert.
"contact_list": "Newsletter"

Beispiel

Ein Newsletter mit allem aktiviert.

curl -X POST https://mail.sendcorex.com/v3.0/send \
  -H "Authorization: Bearer $SENDCOREX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": "subscriber@example.com",
  "from": "news@yourdomain.com",
  "sender_name": "The Weekly",
  "subject": "Issue #42",
  "body": "<p>This week in tech...</p><a href=\"[unsubscribe]\">Unsubscribe</a>",
  "track": "Weekly Newsletter",
  "track_opens": true,
  "track_clicks": true,
  "unsubscribe": true,
  "contact_list": "Newsletter"
}'

Wo Sie die Ergebnisse sehen

Nichts zu konfigurieren. Die erste E-Mail mit einem Track erscheint sofort in Ihrem Dashboard.

Analytics

Wie viele geöffnet und geklickt haben

Jeder Track ist eine Zeile in der Tabelle Sends, neben Ihren Kampagnen. Öffnen Sie ihn für den vollständigen Bericht: Aktivität nach Stunde, beste Versandzeit, Provider, Geräte, Länder und Top-Links.

Analytics öffnen

Kontakte

Jeder Empfänger, gespeichert

Empfänger werden in der Kontaktliste Ihrer Wahl gespeichert (oder in "API Contacts"). Jeder Kontakt behält seinen Verlauf: empfangen, geöffnet, geklickt, gebounct, abgemeldet.

Kontakte öffnen

Personen

Wer geöffnet, wer geklickt hat

Öffnen Sie in Analytics Ihren Track und klicken Sie auf "Who opened", "Who clicked" oder "Unsubscribed". Ihre Kontakte öffnen sich bereits gefiltert — exportieren, taggen oder einer Liste hinzufügen.

Sehen, wer geöffnet hat

Antwort

Die übliche Versandantwort, plus was das Tracking gemacht hat.

200 OK
{
  "success": true,
  "code": "EMAIL_QUEUED_SUCCESS",
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "recipients": 1,
  "track": "Weekly Newsletter",
  "track_id": "6ad757c8aaf59feb",
  "contact_list": "Newsletter"
}
track

Der verwendete Track-Name, ohne Leerzeichen am Anfang und Ende. Fehlt, wenn die E-Mail keinen track hat.

track_id

Stabile ID des Tracks: Derselbe Name ergibt immer dieselbe ID.

contact_list

Die Liste, in der die Empfänger gespeichert wurden. Fehlt, wenn nichts gespeichert wird.

warnings

Was wir angepasst haben, ohne den Versand scheitern zu lassen: veraltetes [[Name]] gefunden, Track-Limit erreicht.

CodeHTTPWann
MISSING_UNSUBSCRIBE_PLACEHOLDER400unsubscribe ist true, aber der Body enthält kein [unsubscribe]. Es wird nichts gesendet.
UNSUBSCRIBE_UNAVAILABLE503Die Abmeldung ist vorübergehend nicht verfügbar. Es wird nichts gesendet — versuchen Sie es gleich noch einmal.

Gut zu wissen

Jede Schreibweise funktioniert

sender_name, senderName und SENDER-NAME sind dasselbe Feld: Groß-/Kleinschreibung, _ und - spielen keine Rolle. Ja/Nein-Felder akzeptieren true, 1 oder "true".

500 Tracks pro Konto

Über dem Limit geht die E-Mail trotzdem raus, nur ohne track, und die Antwort meldet das in warnings.

Mehrere Empfänger

Mit bis zu 50 Adressen in to erhält jede ihr eigenes Tracking und ihren eigenen Abmeldelink.

Geplante E-Mails

scheduled_at funktioniert mit allen Feldern dieser Seite — das Tracking beginnt, wenn die E-Mail rausgeht.

Veraltet

Das alte [[Name]]-Tag

E-Mails, die das Tag noch enthalten, funktionieren weiter. Neue Integrationen sollten die Felder oben verwenden.

Irgendwo im body
<p>Welcome aboard!</p>
<p>[[CRM Welcome List]]</p>

Was es tut

Das Tag wird aus der E-Mail entfernt. "CRM Welcome List" wird zum Track und zur Kontaktliste, mit Öffnungen und Klicks an und Abmeldung aus.

Beides kombinieren

Wenn Sie zusätzlich die neuen Felder senden, haben diese Vorrang: Das Tag füllt nur aus, was Sie weggelassen haben.

Veraltet

Konten, die das Tag noch nutzen, erhalten höchstens einmal pro Woche eine E-Mail mit der Bitte umzustellen. Bis dahin funktioniert es weiter.

Alte Referenzcodes

Ein Code wie [[7CK-JDL-Y1L]] wird jetzt als Track mit diesem Namen gelesen. Die alten Tracking-Endpoints wurden entfernt — alles befindet sich in Analytics.