Kontakte
Verwalten Sie Ihre Zielgruppe per API
Halten Sie Ihre Kontakte mit Ihrer App synchron. Importieren Sie Tausende auf einmal, taggen Sie sie, speichern Sie eigene Felder, organisieren Sie sie in Listen und finden Sie genau die Empfänger, alles über einen einzigen Endpoint.
- REST
- JSON
- Bulk bis 10.000 pro Request
- Listen, Tags und Felder
- Segmente
https://g.sendcorex.com/v1/contactsSo funktioniert es
Ein Kontakt pro E-Mail
Ein Kontakt gehört zu Ihrem Konto, nicht zu einer Liste. Listen, Tags, benutzerdefinierte Felder und Status sind Attribute dieses einen Kontakts, es wird also nichts dupliziert.
Ein Endpoint für alles
Importieren, taggen, abfragen, abmelden, Listen und Segmente verwalten: Jede Aktion ist ein Befehl an POST /v1/contacts. Bis zu 20 Befehle pro Request.
Für Massenverarbeitung gebaut
Jede Aktion nimmt bis zu 500 E-Mails und antwortet E-Mail für E-Mail. Eine fehlerhafte Zeile schlägt allein fehl; der Rest des Stapels geht durch.
Erste Schritte
Vier Schritte, und nur der erste ist vor Ihrem ersten Request Pflicht.
- 1
API Key erstellen
Öffnen Sie im Dashboard Developers → API Keys und erstellen Sie einen Schlüssel. Geben Sie ihm die Kontakt-Scopes, die Ihre App braucht.
Das Webmail-Token funktioniert hier nicht. Kontakte verwenden denselben Dashboard-API-Key, mit dem Sie E-Mails senden.
- 2
Scopes wählen
Reine Lese-Integrationen brauchen nur contact:read. Ein Sync, der importiert und aktualisiert, braucht contact:create und contact:update.
- 3
Felder und Listen definieren
Legen Sie die benutzerdefinierten Felder an, die Sie speichern möchten (Tarif, Stadt, Geburtstag …), und die Listen, an die Sie senden. Das geht auch im Dashboard.
- 4
Importieren und abfragen
Senden Sie Ihre Kontakte mit Upsert Contacts und finden Sie sie dann mit Query Contacts.
Scopes
Jeder Befehl braucht einen Scope auf dem Schlüssel. Fehlt einer, schlägt nur dieser Befehl fehl mit MISSING_SCOPE; der Rest des Requests läuft trotzdem.
contact:readKontakte, Listen, Felder, Segmente, Ereignisse und Statistiken lesen.
contact:createListen, Felder und Segmente anlegen. Upsert braucht ihn ebenfalls, um neue Kontakte anzulegen.
contact:updateKontakte, Tags, Status, Felder und Listenmitgliedschaften aktualisieren.
contact:deleteKontakte, Listen, Felder und Segmente löschen.
Die vollständige Liste Befehl für Befehl finden Sie unter Run Commands. Jede Befehlsseite nennt außerdem den benötigten Scope.
Der Kontakt
Jeder Lesezugriff liefert Kontakte in dieser Form. Sie schreiben nur die Teile, die Sie brauchen.
{
"email": "ana@acme.com",
"domain": "acme.com",
"first_name": "Ana",
"last_name": "Costa",
"phone": null,
"company": "Acme",
"locale": "pt-BR",
"timezone": "America/Sao_Paulo",
"source": "checkout",
"status": "subscribed",
"status_reason": null,
"status_at": "2026-10-13T06:05:08.323Z",
"created_at": "2026-10-13T06:05:08.323Z",
"updated_at": "2026-10-14T09:12:40.118Z",
"tags": [
"customer",
"vip"
],
"lists": {
"customers": {
"subscribed": true,
"sendable": true,
"added_at": "2026-10-13T06:05:08.323Z",
"unsubscribed_at": null
}
},
"fields": {
"plan": "pro",
"age": 31,
"city": "São Paulo"
},
"stats": {
"sent_count": 12,
"open_count": 7,
"click_count": 2,
"bounce_count": 0,
"complaint_count": 0,
"open_rate": 0.58,
"click_rate": 0.17,
"first_open_at": "2026-10-13T08:41:02.000Z",
"last_open_at": "2026-10-14T21:03:55.000Z",
"last_click_at": "2026-10-14T21:04:10.000Z",
"last_sent_at": "2026-10-14T20:58:31.000Z"
}
}statusGlobal. Ein abgemeldeter, gebouncter, beschwerdeführender oder gesperrter Kontakt ist in keiner Liste anschreibbar.
listsMitgliedschaft und Anmeldung pro Liste. Jemand kann eine Liste verlassen und in den anderen bleiben.
sendableFür die Liste angemeldet und mit Status subscribed. An diese Kontakte senden Kampagnen.
statsSendungen, Öffnungen und Klicks aus dem Tracking. Nur lesbar, und Sie können danach filtern und sortieren.
Ihr erster Request
Importieren Sie zwei Kontakte und lesen Sie sie zurück, in einem einzigen Request. Ersetzen Sie SENDCOREX_API_KEY durch Ihren API Key.
curl -X POST 'https://g.sendcorex.com/v1/contacts' \
-H "Authorization: $SENDCOREX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"commands": [
{ "command": "upsert_contacts", "args": {
"tags": ["imported"],
"contacts": [
{ "email": "ana@acme.com", "first_name": "Ana", "company": "Acme" },
{ "email": "bob@gmail.com", "first_name": "Bob" }
]
} },
{ "command": "query_contacts", "args": { "where": { "tags": { "has": "imported" } } } }
]
}' Sie erhalten ein Ergebnis pro Befehl. Das erste nennt, wie viele Kontakte created wurden; das zweite liefert sie zurück. Führen Sie ihn erneut aus, wird nichts geschrieben: Beide Zeilen kommen mit changed: false zurück. Denselben Request in 8 Sprachen finden Sie unter Upsert Contacts.
Häufige Aufgaben
Registrierungen aus Ihrer App synchronisieren
Führen Sie bei jeder Registrierung ein Upsert des Kontakts mit list_id aus. Dieselben Daten erneut zu senden schreibt nichts, Sie können es also auch bei jedem Login aufrufen.
Upsert ContactsEinen Abmeldelink umsetzen
Melden Sie mit Set List Subscription von einer Liste ab oder mit Set Status von allem.
Set List SubscriptionEngagierte Kunden finden
Fragen Sie nach Liste, Tag und last_open_at ab, sortiert nach open_rate. Speichern Sie es als Segment zur Wiederverwendung.
Query ContactsEine Liste exportieren
Durchlaufen Sie List Members mit sendable_only und wählen Sie nur die benötigten Felder, 5.000 Mitglieder pro Seite.
List MembersVollständige Referenz
Alles, was mit CMD markiert ist, ist ein Befehl über POST /v1/contacts, bis zu 20 pro Request.
Routen
1Kontakte
4Suche
2Tags, Status und Felder
5Listen
9- CMDList ListsAlle Listen, mit Zählern
- CMDGet ListEine Liste und ihre Zähler
- CMDCreate ListEigene oder erzeugte ID
- CMDUpdate ListName, Beschreibung, benutzerdefinierte Daten
- CMDDelete ListKontakte bleiben erhalten
- CMDList MembersListe durchlaufen, nur anschreibbare
- CMDAdd To ListsEiner oder mehreren Listen beitreten
- CMDRemove From ListsEine oder mehrere Listen verlassen
- CMDSet List SubscriptionVon einer Liste abmelden