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.
trackstringDer 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_opensbooleanZä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_clicksbooleanZä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
unsubscribebooleanNutzen 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_liststringDie 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 öffnenKontakte
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 öffnenPersonen
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 hatAntwort
Die übliche Versandantwort, plus was das Tracking gemacht hat.
{
"success": true,
"code": "EMAIL_QUEUED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"recipients": 1,
"track": "Weekly Newsletter",
"track_id": "6ad757c8aaf59feb",
"contact_list": "Newsletter"
}trackDer verwendete Track-Name, ohne Leerzeichen am Anfang und Ende. Fehlt, wenn die E-Mail keinen track hat.
track_idStabile ID des Tracks: Derselbe Name ergibt immer dieselbe ID.
contact_listDie Liste, in der die Empfänger gespeichert wurden. Fehlt, wenn nichts gespeichert wird.
warningsWas wir angepasst haben, ohne den Versand scheitern zu lassen: veraltetes [[Name]] gefunden, Track-Limit erreicht.
| Code | HTTP | Wann |
|---|---|---|
MISSING_UNSUBSCRIBE_PLACEHOLDER | 400 | unsubscribe ist true, aber der Body enthält kein [unsubscribe]. Es wird nichts gesendet. |
UNSUBSCRIBE_UNAVAILABLE | 503 | Die 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.
<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.