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.

POSThttps://g.sendcorex.com/v1/privacycommand: list_changes
i

Nécessite le scope privacy:read sur votre API key.

i

Conservez next_cursor et envoyez-le au prochain appel. Il revient toujours, même quand rien n'a changé.

i

Les changements apparaissent environ 5 secondes après s'être produits, et le flux conserve les 90 derniers jours.

Arguments

  • cursorstringfacultatif

    Le next_cursor de l'appel précédent. Sans lui, vous commencez au début des 90 jours.

    ex. : "ZjowMDAwMDAwMDgzOjE3NjEyOTA0MTIwMzE6amFuZS5kb2VAZXhhbXBsZS5jb20"

  • limitnumberfacultatif

    Changements 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

  • changes

    Les changements de cet appel, du plus ancien au plus récent. Chacun est l'état complet du destinataire après le changement.

  • next_cursor

    Envoyez-le comme cursor au prochain appel.

  • has_more

    true lorsque d'autres changements attendent déjà : rappelez immédiatement.

  • changes[].email

    L'adresse du destinataire, en minuscules.

  • changes[].track_opens

    true le destinataire autorise le suivi des ouvertures, false il l'a refusé, null il n'a jamais choisi.

  • changes[].track_clicks

    true le destinataire autorise le suivi des clics, false il l'a refusé, null il n'a jamais choisi.

  • changes[].source

    Qui a fait le changement : page (le destinataire, sur la page des préférences de tracking), api (vous, avec Set Preferences) ou dashboard.

  • changes[].updated_at

    Quand 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);
i

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.

  • 401INVALID_API_KEY

    L'API key n'existe pas, a été révoquée ou a été désactivée dans le dashboard.

  • 429RATE_LIMITED

    Plus 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.

  • CMDMISSING_SCOPE

    L'API key n'a pas le scope de cette commande (`privacy:read` pour lire, `privacy:write` pour modifier).

  • CMDINVALID_ARGS

    Un argument est invalide : `email` manquant ou mal formé, plus de 100 `emails`, `track_opens` qui ne vaut pas `true`/`false`, limit hors limites…

  • CMDINVALID_CURSOR

    Le cursor est mal formé ou provient d'un autre compte. Recommencez sans cursor.

  • CMDINTERNAL

    Erreur serveur. Le détail n'est écrit que dans le log du serveur.