Tracking Preferences: Lesen
Änderungen auflisten
Jede Präferenzänderung Ihres Kontos, älteste zuerst, mit einem Cursor. Halten Sie Ihr CRM synchron, ohne eine zu verpassen.
https://g.sendcorex.com/v1/privacycommand: list_changesErfordert den Scope privacy:read für Ihren API key.
Behalten Sie next_cursor und senden Sie ihn beim nächsten Aufruf. Er kommt immer zurück, auch wenn sich nichts geändert hat.
Änderungen erscheinen etwa 5 Sekunden, nachdem sie passiert sind, und der Feed enthält die letzten 90 Tage.
Argumente
cursorstringoptionalDer
next_cursordes vorherigen Aufrufs. Ohne ihn beginnen Sie am Anfang der 90 Tage.z. B.
"ZjowMDAwMDAwMDgzOjE3NjEyOTA0MTIwMzE6amFuZS5kb2VAZXhhbXBsZS5jb20"limitnumberoptionalÄnderungen pro Aufruf, von 1 bis 1000. Standard: 100.
z. B.
100
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/privacy',
{
commands: [
{
command: "list_changes",
args: {
cursor: "ZjowMDAwMDAwMDgzOjE3NjEyOTA0MTIwMzE6amFuZS5kb2VAZXhhbXBsZS5jb20",
limit: 100
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Antwort
{
"type": "SUCCESS",
"results": [
{
"command": "list_changes",
"id": "0",
"type": "SUCCESS",
"took_ms": 6,
"data": {
"changes": [
{
"email": "jane.doe@example.com",
"track_opens": false,
"track_clicks": true,
"source": "page",
"updated_at": "2026-10-24T07:20:12.031Z"
},
{
"email": "marc.dupont@example.fr",
"track_opens": false,
"track_clicks": false,
"source": "api",
"updated_at": "2026-10-24T07:41:55.508Z"
}
],
"next_cursor": "ZjowMDAwMDAwMDgzOjE3NjEyOTA0MTIwMzE6amFuZS5kb2VAZXhhbXBsZS5jb20",
"has_more": false
}
}
]
}Antwortfelder
changesDie Änderungen dieses Aufrufs, älteste zuerst. Jede ist der vollständige Zustand des Empfängers nach der Änderung.
next_cursorSenden Sie ihn beim nächsten Aufruf als
cursor.has_moretrue, wenn bereits weitere Änderungen warten: Rufen Sie sofort erneut auf.changes[].emailDie Empfängeradresse, in Kleinbuchstaben.
changes[].track_openstrueder Empfänger erlaubt das Tracking von Öffnungen,falseer hat es abgelehnt,nuller hat nie gewählt.changes[].track_clickstrueder Empfänger erlaubt das Tracking von Klicks,falseer hat es abgelehnt,nuller hat nie gewählt.changes[].sourceWer die Änderung vorgenommen hat:
page(der Empfänger, auf der Seite für Tracking-Präferenzen),api(Sie, mit Set Preferences) oderdashboard.changes[].updated_atWann die Änderung erfolgte. ISO 8601, UTC.
Mit Ihrem CRM synchronisieren
Speichern Sie den Cursor an einem Ort, der einen Neustart übersteht. Lesen Sie bei jedem Durchlauf, bis has_more false ist, und schreiben Sie jede Änderung in den Kontakt in Ihrem CRM (Salesforce, HubSpot…).
Node.js
let cursor = await loadCursor(); // null the first time
async function sync() {
let more = true;
while (more) {
const [r] = await call({ command: 'list_changes', args: cursor ? { cursor, limit: 500 } : { limit: 500 } });
for (const c of r.data.changes) {
if (c.source === 'api') continue; // you made this change yourself
await crm.updateContact(c.email, { trackOpens: c.track_opens, trackClicks: c.track_clicks, consentAt: c.updated_at });
}
cursor = r.data.next_cursor;
await saveCursor(cursor);
more = r.data.has_more;
}
}
setInterval(sync, 60_000);Lieber Push? Der Webhook tracking_preferences_updated sendet jede auf der Seite vorgenommene Änderung in dem Moment, in dem sie passiert. Nutzen Sie diesen Befehl als Sicherheitsnetz.
Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 401
INVALID_API_KEYDer API key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.
- 429
RATE_LIMITEDMehr als 15 Requests/s oder 15 gleichzeitig für dieselbe IP + API key. Warten Sie die Anzahl Sekunden aus Retry-After ab.
- CMD
MISSING_SCOPEDer API key hat nicht den Scope dieses Befehls (`privacy:read` zum Lesen, `privacy:write` zum Ändern).
- CMD
INVALID_ARGSEin Argument ist ungültig: fehlende oder fehlerhafte `email`, mehr als 100 `emails`, `track_opens`, das nicht `true`/`false` ist, limit außerhalb des Bereichs…
- CMD
INVALID_CURSORDer Cursor ist fehlerhaft oder stammt aus einem anderen Konto. Beginnen Sie ohne Cursor neu.
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.