Recevoir des emails : Contacts et audience
Enregistrer un segment
Crée ou met à jour un segment de cette boîte.
https://g.sendcorex.com/v1command: save_segmentUn segment appartient à une boîte. Pour l’utiliser dans une autre boîte, enregistrez-y une copie.
Nécessite la permission d’organiser (pas pour les jetons en lecture seule).
Arguments
segment_idstringfacultatifLaissez-le vide pour créer un nouveau segment.
namestringobligatoireJusqu’à 200 caractères.
whereobjectobligatoireLe filtre. Même format que
list_contacts.sortobjectfacultatif{ field }:email,created_at,last_open_at,last_click_at,open_countouclick_count.
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "save_segment",
args: {
name: "Opened in 30 days",
where: {
last_open_at: {
within_days: 30
}
}
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
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": "save_segment",
"id": "0",
"type": "SUCCESS",
"data": {
"segment": {
"segment_id": "seg_8Hq2",
"name": "Opened in 30 days",
"where": {
"last_open_at": {
"within_days": 30
}
},
"sort": null,
"created_at": "2026-11-21T10:00:00Z",
"updated_at": "2026-11-21T10:00:00Z"
}
}
}
]
}Champs de la réponse
segmentLe segment enregistré.
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
TOKEN_EXPIREDL'access token a expiré. Appelez Refresh Token et relancez la requête.
- 401
INVALID_TOKENLe token est mal formé, inconnu ou révoqué.
- 429
RATE_LIMITEDPlus de 15 requêtes/s ou 15 en cours pour la même IP + boîte aux lettres. Attendez le nombre de secondes indiqué dans Retry-After.
- CMD
INVALID_ARGSUn argument obligatoire est manquant ou invalide.
- CMD
NOT_FOUNDLe message, la conversation ou le dossier n'existe pas pour ce token.
- CMD
READ_ONLY_ACCESSLe token ou l’application a un accès en Lecture seule et la commande écrit. Sur la route d’envoi de pièce jointe, c’est HTTP 403.
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.