Contacts : listes
Créer une liste
Créez une liste. Choisissez votre propre id pour que votre code puisse y faire référence, ou laissez le serveur en générer un.
https://g.sendcorex.com/v1/contactscommand: create_listNécessite le scope contact:create sur votre API key.
Une liste regroupe des contacts pour l'envoi. Le contact appartient au compte : l'ajouter à une liste ne le copie pas.
Arguments
list_idstringfacultatifVotre propre id :
a-z,0-9,_et-, 40 caractères maximum. Généré s'il est omis. Un id déjà existant échoue avecALREADY_EXISTS.ex. :
"customers"namestringfacultatifNom affiché.
ex. :
"Customers"descriptionstringfacultatifTexte libre affiché avec la liste.
sourcestringfacultatifD'où viennent les contacts, pour votre information.
ex. :
"checkout"customobjectfacultatifVos propres données, jusqu'à 50 clés.
ex. :
{ "origin": "checkout", "year": 2026 }
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/contacts',
{
commands: [
{
command: "create_list",
args: {
list_id: "customers",
name: "Customers",
description: "Everyone who bought at least once",
source: "checkout",
custom: {
origin: "checkout",
year: 2026
}
}
}
]
},
{ 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": "create_list",
"id": "0",
"type": "SUCCESS",
"took_ms": 14,
"data": {
"list_id": "customers",
"name": "Customers",
"description": "Everyone who bought at least once",
"source": "checkout",
"status": "ready",
"custom": {
"origin": "checkout",
"year": 2026
},
"created_at": "2026-10-01T10:00:00.000Z",
"updated_at": "2026-10-12T15:22:41.000Z",
"stats": {
"total": 0,
"ok": 0,
"opened": 0,
"clicked": 0
}
}
}
]
}Champs de la réponse
list_idL'id envoyé ou celui qui a été généré.
statusready.statsCompteurs, tous à
0pour une nouvelle liste.
Ensuite : la remplir
Envoyez list_id avec Upsert Contacts pour importer directement dans la liste, ou utilisez Add To Lists pour les contacts que vous avez déjà.
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 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 requis par cette commande. Les autres commandes de la requête s'exécutent quand même.
- CMD
INVALID_ARGSUn argument obligatoire est manquant ou invalide : email, valeur de champ, option d'enum, clé de where, id de liste…
- CMD
ALREADY_EXISTScreate_list a été appelé avec un list_id qui existe déjà.
- CMD
INTERNALErreur serveur. Le détail n'est écrit que dans le log du serveur.