Tracking Preferences : Lecture
Lister les modifications
Chaque changement de préférence de votre compte, du plus ancien au plus récent, avec un cursor. Gardez votre CRM synchronisé sans en manquer un.
https://g.sendcorex.com/v1/privacycommand: list_changesNécessite le scope privacy:read sur votre API key.
Conservez next_cursor et envoyez-le au prochain appel. Il revient toujours, même quand rien n'a changé.
Les changements apparaissent environ 5 secondes après s'être produits, et le flux conserve les 90 derniers jours.
Arguments
cursorstringfacultatifLe
next_cursorde l'appel précédent. Sans lui, vous commencez au début des 90 jours.ex. :
"ZjowMDAwMDAwMDgzOjE3NjEyOTA0MTIwMzE6amFuZS5kb2VAZXhhbXBsZS5jb20"limitnumberfacultatifChangements par appel, de 1 à 1000. Par défaut : 100.
ex. :
100
Démarrage rapide
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);Réponse
{
"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
}
}
]
}Champs de la réponse
changesLes changements de cet appel, du plus ancien au plus récent. Chacun est l'état complet du destinataire après le changement.
next_cursorEnvoyez-le comme
cursorau prochain appel.has_moretruelorsque d'autres changements attendent déjà : rappelez immédiatement.changes[].emailL'adresse du destinataire, en minuscules.
changes[].track_openstruele destinataire autorise le suivi des ouvertures,falseil l'a refusé,nullil n'a jamais choisi.changes[].track_clickstruele destinataire autorise le suivi des clics,falseil l'a refusé,nullil n'a jamais choisi.changes[].sourceQui a fait le changement :
page(le destinataire, sur la page des préférences de tracking),api(vous, avec Set Preferences) oudashboard.changes[].updated_atQuand le changement a été fait. ISO 8601, UTC.
Synchroniser avec votre CRM
Stockez le cursor quelque part qui survit à un redémarrage. À chaque cycle, lisez jusqu'à ce que has_more vaille false et écrivez chaque changement dans le contact de votre 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);Vous préférez le push ? Le webhook tracking_preferences_updated envoie chaque changement fait sur la page au moment où il se produit. Utilisez cette commande comme filet de sécurité.
Erreurs
Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.
- 401
INVALID_API_KEYL'API key n'existe pas, a été révoquée ou a été désactivée dans le dashboard.
- 429
RATE_LIMITEDPlus de 15 requêtes/s ou 15 simultanées pour la même IP + API key. Attendez le nombre de secondes indiqué dans Retry-After.
- CMD
MISSING_SCOPEL'API key n'a pas le scope de cette commande (`privacy:read` pour lire, `privacy:write` pour modifier).
- CMD
INVALID_ARGSUn argument est invalide : `email` manquant ou mal formé, plus de 100 `emails`, `track_opens` qui ne vaut pas `true`/`false`, limit hors limites…
- CMD
INVALID_CURSORLe cursor est mal formé ou provient d'un autre compte. Recommencez sans cursor.
- CMD
INTERNALErreur serveur. Le détail n'est écrit que dans le log du serveur.