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
POSThttps://g.sendcorex.com/v1/contacts

So 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. 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. 2

    Scopes wählen

    Reine Lese-Integrationen brauchen nur contact:read. Ein Sync, der importiert und aktualisiert, braucht contact:create und contact:update.

  3. 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. 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:read

    Kontakte, Listen, Felder, Segmente, Ereignisse und Statistiken lesen.

  • contact:create

    Listen, Felder und Segmente anlegen. Upsert braucht ihn ebenfalls, um neue Kontakte anzulegen.

  • contact:update

    Kontakte, Tags, Status, Felder und Listenmitgliedschaften aktualisieren.

  • contact:delete

    Kontakte, Listen, Felder und Segmente löschen.

i

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"
  }
}
status

Global. Ein abgemeldeter, gebouncter, beschwerdeführender oder gesperrter Kontakt ist in keiner Liste anschreibbar.

lists

Mitgliedschaft und Anmeldung pro Liste. Jemand kann eine Liste verlassen und in den anderen bleiben.

sendable

Für die Liste angemeldet und mit Status subscribed. An diese Kontakte senden Kampagnen.

stats

Sendungen, Ö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 Contacts

Einen Abmeldelink umsetzen

Melden Sie mit Set List Subscription von einer Liste ab oder mit Set Status von allem.

Set List Subscription

Engagierte Kunden finden

Fragen Sie nach Liste, Tag und last_open_at ab, sortiert nach open_rate. Speichern Sie es als Segment zur Wiederverwendung.

Query Contacts

Eine Liste exportieren

Durchlaufen Sie List Members mit sendable_only und wählen Sie nur die benötigten Felder, 5.000 Mitglieder pro Seite.

List Members

Vollständige Referenz

Alles, was mit CMD markiert ist, ist ein Befehl über POST /v1/contacts, bis zu 20 pro Request.