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.

POSThttps://g.sendcorex.com/v1command: send_email
i

queued: 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.

i

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.

i

Les destinataires qui ont refusé le suivi sur la page de préférences ne sont jamais suivis, même avec true.

i

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.

i

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.

i

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[]obligatoire

    Adresse du destinataire, ou une liste de 30 adresses maximum (offres payantes). Avec unsubscribe: true chaque personne reçoit sa propre copie ; sans, tout le monde en to et cc se voit.

  • to_namestringfacultatif

    Nom du destinataire. Par défaut, la partie avant le @.

  • subjectstringobligatoire

    Objet de l'e-mail.

  • htmlstringfacultatif

    Corps HTML. Envoyez html ou text.

  • textstringfacultatif

    Corps en texte brut. Il est converti en HTML avec <br>.

  • ccstring[]facultatif

    Copies visibles. to + cc + bcc jusqu'à 50 adresses.

  • bccstring[]facultatif

    Copies cachées. Elles n'apparaissent jamais dans les headers.

  • template_idstringfacultatif

    Remplit le corps (et un objet vide) à partir d'un template. Les placeholders utilisent to_name et variables.

  • variablesobjectfacultatif

    Vos propres placeholders de template : { "company": "Acme" } remplit {company}.

  • attachmentsobject[]facultatif

    Fichiers : [{ file_name, content, content_type }], content en base64. Jusqu'à 20 fichiers, 25 Mo au total. Chaque fichier est analysé.

  • compose_uidstringfacultatif

    Pièces jointes envoyées au préalable avec upload_attachment.

  • attachment_idsstring[]facultatif

    Quelles pièces jointes envoyées utiliser. Sans ce paramètre, toutes.

  • followup_atstringfacultatif

    Vous rappelle si personne ne répond avant cette date (RFC 3339, YYYY-MM-DD ou epoch ms).

  • labelstringfacultatif

    Un libellé à poser sur le message envoyé. Il devient labels: [label].

  • track_opensbooleanfacultatif

    Suit le moment où chaque destinataire ouvre l’e-mail (pixel invisible). Par défaut true.

  • track_clicksbooleanfacultatif

    Suit les clics sur les liens (chaque lien passe par une redirection). Par défaut true.

  • unsubscribebooleanfacultatif

    Ajoute un lien de désinscription. Placez [unsubscribe] dans le corps (dans le href d’un lien ou en texte) à l’endroit du lien ; sans lui, une ligne par défaut est ajoutée à la fin. Par défaut false.

  • audiencestringfacultatif

    Envoie à une audience au lieu d’adresses : subscribed, opened, clicked, both, seg:<segment_id> ou msg:<message_uid>:opened|clicked|not_opened. to devient 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_uid

    L'id du message envoyé. Il apparaît immédiatement dans Sent.

  • thread_id

    La conversation du nouveau message.

  • message_id

    Un Message-ID provisoire. Le vrai Message-ID SMTP le remplace peu après.

  • recipients

    Nombre de copies mises en file (to + cc + bcc), 1 crédit chacune.

  • queued

    true = 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.

  • 401TOKEN_EXPIRED

    L'access token a expiré. Appelez Refresh Token et relancez la requête.

  • 401INVALID_TOKEN

    Le token est mal formé, inconnu ou révoqué.

  • 429RATE_LIMITED

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

  • CMDINVALID_AUDIENCE

    L’audience n’est pas valide : groupe inconnu, segment d’une autre boîte ou message non envoyé par cette boîte.

  • CMDAUDIENCE_OVER_LIMIT

    L’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.

  • CMDEMPTY_AUDIENCE

    Personne dans cette audience pour l’instant.

  • CMDRECIPIENT_UNSUBSCRIBED

    Un ou plusieurs destinataires se sont désinscrits de cette boîte. `recipients` les liste : retirez-les ou renvoyez avec `unsubscribe: false`.

  • CMDPAID_PLAN_REQUIRED

    Plusieurs adresses dans `to` nécessitent une offre payante.

  • CMDTOO_MANY_RECIPIENTS

    `to` contient plus de 30 adresses.

  • CMDINVALID_ARGS

    Un argument obligatoire est manquant ou invalide.

  • CMDINVALID_TOADDRESS

    L'adresse to n'est pas un e-mail valide.

  • CMDINVALID_CCADDRESS

    L'une des adresses cc n'est pas un e-mail valide.

  • CMDINVALID_BCCADDRESS

    L'une des adresses bcc n'est pas un e-mail valide.

  • CMDRECIPIENT_LIMIT_EXCEEDED

    to, cc et bcc réunis comptent plus de 50 adresses.

  • CMDINVALID_ATTACHMENT

    Le contenu d'une pièce jointe n'est pas du base64 valide.

  • CMDFILE_BLOCKED

    Un fichier a été bloqué par l'analyse de sécurité.

  • CMDATTACHMENTS_TOO_LARGE

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

  • CMDATTACHMENT_MISSING

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

  • CMDNO_CREDITS

    Le compte a moins de crédits e-mail que de destinataires (1 crédit par copie).

  • CMDSENDER_NOT_FOUND

    L'expéditeur associé au token n'est pas enregistré.

  • CMDSENDER_NO_DOMAIN

    L'expéditeur associé au token n'a pas de domaine.

  • CMDINTERNAL

    Erreur serveur. Le détail est uniquement écrit dans le log du serveur.