Recevoir des e-mails : Programmation
Programmer un envoi
Rédigez l'e-mail maintenant et envoyez-le plus tard. Il attend dans le dossier Scheduled jusqu'à l'heure choisie.
https://g.sendcorex.com/v1command: schedule_sendTout ce qui peut être vérifié l'est maintenant (destinataire, objet, e-mail d'origine, pièces jointes), pour que vous soyez prévenu avant l'heure. Les crédits et la limite quotidienne sont vérifiés à l'envoi.
Si l'envoi est refusé à ce moment-là (pas de crédits, limite quotidienne, spam), rien n'est perdu : l'e-mail retourne dans les Brouillons avec la raison.
Les destinataires qui ont refusé le suivi sur la page de préférences ne sont jamais suivis, même avec true.
Les e-mails envoyés depuis la boîte ne contiennent ni en-tête List-Unsubscribe ni lien de désinscription, sauf si vous envoyez unsubscribe: true, car ce sont des e-mails personnels.
Toute personne qui reçoit un e-mail de la boîte devient un contact de la liste « Webmail » du compte et devient trusted dans cette boîte : ses réponses arrivent dans l’Inbox et l’adresse apparaît dans l’autocomplétion. Les expéditeurs bloqués par la boîte restent bloqués.
Avec unsubscribe: true, les destinataires déjà désinscrits de cette boîte sont refusés avec RECIPIENT_UNSUBSCRIBED, et recipients les liste. Les réponses ne sont jamais bloquées.
Arguments
send_atstringobligatoireRFC 3339,
YYYY-MM-DDou epoch ms. Au moins 1 minute à partir de maintenant et jusqu'à 1 an.modestringfacultatifnew(par défaut),replyouforward.idstringfacultatifLe message d'origine, pour
replyetforward.tostring | string[]facultatifDestinataire. Obligatoire pour
newetforward. Pournew, il peut s’agir d’une liste de 30 maximum (offres payantes).ccstring[]facultatifCopies visibles.
bccstring[]facultatifCopies cachées.
subjectstringfacultatifObligatoire pour
new. Reply et forward utilisent par défaut Re: / Fwd: original.htmlstringfacultatifCorps HTML. Ou
text, outemplate_id.template_idstringfacultatifRemplit le corps (et l'objet d'un nouvel e-mail) à partir d'un template.
followup_after_hoursnumberfacultatifVous rappelle si personne ne répond dans ce nombre d'heures après l'envoi.
scheduled_idstringfacultatifReprogrammer : l'ancien e-mail programmé est remplacé.
attachmentsobject[]facultatifFichiers à joindre :
[{ file_name, content, content_type }],contenten base64. Jusqu'à 20 fichiers et 25 Mo au total. Chaque fichier est analysé ; un fichier dangereux échoue avecFILE_BLOCKED.compose_uidstringfacultatifPièces jointes que vous avez envoyées au préalable avec
upload_attachment.attachment_idsstring[]facultatifLesquelles des pièces jointes envoyées utiliser. Sans ce paramètre, toutes.
track_opensbooleanfacultatifSuit le moment où chaque destinataire ouvre l’e-mail (pixel invisible). Par défaut
true.track_clicksbooleanfacultatifSuit les clics sur les liens (chaque lien passe par une redirection). Par défaut
true.unsubscribebooleanfacultatifAjoute un lien de désinscription. Placez
[unsubscribe]dans le corps (dans lehrefd’un lien ou en texte) à l’endroit du lien ; sans lui, une ligne par défaut est ajoutée à la fin. Par défautfalse.audiencestringfacultatifEnvoie à une audience au lieu d’adresses :
subscribed,opened,clicked,both,seg:<segment_id>oumsg:<message_uid>:opened|clicked|not_opened.todevient facultatif. Jusqu’à 5 000 personnes. Le lien de désinscription est activé et l’email part comme marketing. Offres payantes.best_timebooleanfacultatifEnvoie à chaque personne à l’heure où elle ouvre ou clique habituellement, pendant la journée de
send_at. Nécessiteaudienceetmode: new.send_atest 00:00 de ce jour dans votre fuseau, en UTC.best_fallback_atstring | numberfacultatifHeure pour les personnes sans historique (RFC 3339 ou epoch ms). Doit être le même jour que
send_at.
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "schedule_send",
args: {
to: "ana@client.com",
subject: "Proposal",
html: "<p>Hi Ana, here is the proposal.</p>",
send_at: "2026-10-27T09:00:00+08:00"
}
}
]
},
{ 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": "schedule_send",
"id": "0",
"type": "SUCCESS",
"data": {
"scheduled_id": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"send_at": "2026-10-27T01:00:00Z"
}
}
]
}Champs de la réponse
scheduled_idLe message dans Scheduled. Utilisez-le pour annuler, reprogrammer ou envoyer maintenant.
Lister ce qui est programmé
Les e-mails programmés sont dans le dossier Scheduled, triés par heure d'envoi.
Body de la requête
{
"commands": [
{
"command": "list_messages",
"args": {
"folder": "Scheduled"
}
}
]
}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_AUDIENCEL’audience n’est pas valide : groupe inconnu, segment d’une autre boîte ou message non envoyé par cette boîte.
- CMD
AUDIENCE_OVER_LIMITL’audience compte plus de personnes que vous ne pouvez en envoyer (jusqu’à 5 000 par email et votre limite quotidienne). `total` et `allowed` indiquent combien.
- CMD
EMPTY_AUDIENCEPersonne dans cette audience pour l’instant.
- CMD
BEST_TIME_NEEDS_AUDIENCE`best_time` nécessite un `audience` et `mode: new`.
- CMD
RECIPIENT_UNSUBSCRIBEDUn ou plusieurs destinataires se sont désinscrits de cette boîte. `recipients` les liste : retirez-les ou renvoyez avec `unsubscribe: false`.
- CMD
PAID_PLAN_REQUIREDPlusieurs adresses dans `to` nécessitent une offre payante.
- CMD
TOO_MANY_RECIPIENTS`to` contient plus de 30 adresses.
- CMD
INVALID_ARGSUn argument obligatoire est manquant ou invalide.
- CMD
INVALID_TIMEsend_at est manquant, à moins de 1 minute ou à plus de 1 an.
- CMD
INVALID_RECIPIENTLe destinataire est manquant ou n'est pas un e-mail valide.
- CMD
MISSING_SUBJECTUn nouvel e-mail a besoin d'un objet.
- CMD
MISSING_TARGETReply et forward ont besoin de l'e-mail d'origine, qui doit encore exister.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc et bcc réunis comptent plus de 50 adresses.
- CMD
FILE_BLOCKEDUn fichier a été bloqué par l'analyse de sécurité.
- CMD
ATTACHMENTS_TOO_LARGELes pièces jointes de l'e-mail dépassent 25 Mo au total, ou la boîte aux lettres a déjà 500 Mo de fichiers envoyés en attente d'envoi.
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.