Recevoir des e-mails : Envoi et confiance
Envoyer un e-mail
Envoyez un nouvel e-mail depuis l'expéditeur associé à votre token. Le message est enregistré dans Envoyés immédiatement et remis en arrière-plan.
https://g.sendcorex.com/v1command: send_emailqueued: true signifie enregistré et en attente dans la file, pas remis. Le message_id de la réponse est provisoire : le vrai Message-ID SMTP le remplace quelques secondes plus tard et apparaît dans get_messages.
Chaque destinataire (to + cc + bcc) reçoit sa propre copie et consomme 1 crédit. Les adresses en bcc n'apparaissent jamais dans les headers. Le corps est limité à 2 Mo, les pièces jointes à 25 Mo au total.
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
tostring | string[]obligatoireAdresse du destinataire, ou une liste de 30 adresses maximum (offres payantes). Avec
unsubscribe: truechaque personne reçoit sa propre copie ; sans, tout le monde entoetccse voit.to_namestringfacultatifNom du destinataire. Par défaut, la partie avant le
@.subjectstringobligatoireObjet de l'e-mail.
htmlstringfacultatifCorps HTML. Envoyez
htmloutext.textstringfacultatifCorps en texte brut. Il est converti en HTML avec
<br>.ccstring[]facultatifCopies visibles. to + cc + bcc jusqu'à 50 adresses.
bccstring[]facultatifCopies cachées. Elles n'apparaissent jamais dans les headers.
template_idstringfacultatifRemplit le corps (et un objet vide) à partir d'un template. Les placeholders utilisent
to_nameetvariables.variablesobjectfacultatifVos propres placeholders de template :
{ "company": "Acme" }remplit{company}.attachmentsobject[]facultatifFichiers :
[{ file_name, content, content_type }],contenten base64. Jusqu'à 20 fichiers, 25 Mo au total. Chaque fichier est analysé.compose_uidstringfacultatifPièces jointes envoyées au préalable avec
upload_attachment.attachment_idsstring[]facultatifQuelles pièces jointes envoyées utiliser. Sans ce paramètre, toutes.
followup_atstringfacultatifVous rappelle si personne ne répond avant cette date (RFC 3339,
YYYY-MM-DDou epoch ms).labelstringfacultatifUn libellé à poser sur le message envoyé. Il devient
labels: [label].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.
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "send_email",
args: {
to: "client@example.com",
to_name: "Client",
cc: [
"manager@example.com"
],
subject: "Quote",
html: "<p>Here is the quote.</p>",
attachments: [
{
file_name: "quote.pdf",
content: "JVBERi0xLjcKJcfsj6IK…",
content_type: "application/pdf"
}
],
followup_at: "2026-10-29T09:00:00+08:00",
label: "sales"
}
}
]
},
{ 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": "send_email",
"id": "0",
"type": "SUCCESS",
"data": {
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"message_id": "<5e0b9c1a-3d7f-4a21-9a6e-2f1c8d4b7e90>",
"recipients": 2,
"queued": true
}
}
]
}Champs de la réponse
message_uidL'id du message envoyé. Il apparaît immédiatement dans
Sent.thread_idLa conversation du nouveau message.
message_idUn Message-ID provisoire. Le vrai Message-ID SMTP le remplace peu après.
recipientsNombre de copies mises en file (to + cc + bcc), 1 crédit chacune.
queuedtrue= enregistré et en file pour la remise. Cela ne signifie pas remis.
Envois répétés
La même écriture (mêmes args) répétée dans un délai de 1,5 seconde renvoie le premier résultat au lieu de renvoyer l'e-mail. Une boucle de polling qui envoie deux fois le même e-mail ne le duplique pas.
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
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_TOADDRESSL'adresse to n'est pas un e-mail valide.
- CMD
INVALID_CCADDRESSL'une des adresses cc n'est pas un e-mail valide.
- CMD
INVALID_BCCADDRESSL'une des adresses bcc n'est pas un e-mail valide.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc et bcc réunis comptent plus de 50 adresses.
- CMD
INVALID_ATTACHMENTLe contenu d'une pièce jointe n'est pas du base64 valide.
- 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
ATTACHMENT_MISSINGUne pièce jointe envoyée n'existe plus (les fichiers non envoyés sous 48 heures, et non utilisés par un brouillon ou un e-mail programmé, sont supprimés). Envoyez-la à nouveau.
- CMD
NO_CREDITSLe compte a moins de crédits e-mail que de destinataires (1 crédit par copie).
- CMD
SENDER_NOT_FOUNDL'expéditeur associé au token n'est pas enregistré.
- CMD
SENDER_NO_DOMAINL'expéditeur associé au token n'a pas de domaine.
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.