E-mail

Envoyer des e-mails en lot

Envoyez le même e-mail à plusieurs destinataires en un seul appel API en passant un tableau dans le champ to. Jusqu'à 50 adresses par appel. Chaque destinataire reçoit un e-mail individuel et les adresses ne sont pas visibles entre elles.

POSThttps://mail.sendcorex.com/v3.0/send
i

Le champ recipients de la réponse confirme le nombre d'adresses acceptées. Les adresses invalides du tableau sont ignorées et signalées dans skipped.

Paramètres du body

  • tostring[]obligatoire

    Tableau d'adresses e-mail des destinataires. 50 maximum par appel.

    ex. ["alice@x.com", "bob@x.com", "carol@x.com"]

Tous les autres paramètres sont identiques à ceux de Envoyer un e-mail.

Démarrage rapide

import axios from 'axios';

const response = await axios.post(
  'https://mail.sendcorex.com/v3.0/send',
  {
    to: [
      'alice@example.com',
      'bob@example.com',
      'carol@example.com',
    ],
    from: 'noreply@yourdomain.com',
    senderName: 'My App',
    subject: 'Important update for all users',
    body: '<p>Here is your update...</p>',
  },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);

const { id, ids, recipients, skipped } = response.data;
console.log('Sent to ' + recipients + ' recipients');

// Invalid addresses are skipped and reported in "skipped"
if (skipped) console.log('Skipped:', skipped);

Réponse

{
  "success": true,
  "message": "Email queued successfully",
  "code": "EMAIL_QUEUED_SUCCESS",
  "id": "a898cf59-4b4e-4547-ad60-c0f818dae7fd",
  "ids": [
    { "id": "a898cf59-4b4e-4547-ad60-c0f818dae7fd", "recipient": "foo@x.com" },
    { "id": "76627061-ab16-4bba-bcfc-ca7ff92ac251", "recipient": "bar@x.com" }
  ],
  "recipients": 2,
  "scheduledAt": null
}

Les erreurs renvoient un objet JSON avec error et code.

  • 401MISSING_AUTH_HEADER

    Aucun en-tête Authorization n'est présent.

  • 401INVALID_API_KEY

    La clé API est invalide ou révoquée.

  • 401ACCOUNT_BLOCKED

    Le compte a été bloqué.

  • 401NO_CREDITS_LEFT

    Crédits e-mail insuffisants pour tous les destinataires. Chaque adresse dans to, cc et bcc utilise 1 crédit.

  • 401DOMAIN_NOT_VALIDATED

    Domaine de l'expéditeur non vérifié.

  • 401LISTED_SPAM_HAUS

    Le domaine de l'expéditeur est listé sur Spamhaus.

  • 401ISP_DOMAIN_BLOCKED

    L'envoi depuis des domaines connus (gmail.com, outlook.com, etc.) n'est pas autorisé.

  • 401FROM_HEADER_DOMAIN_MISMATCH

    Domaine de l'en-tête From non autorisé pour cet expéditeur.

  • 401USER_NOT_FOUND

    Utilisateur introuvable.

  • 401MISSING_USER_PRIVILEGES

    Privilèges utilisateur manquants.

  • 401EMAIL_CREDITS_NOT_FOUND

    Erreur lors de la récupération des crédits e-mail.

  • 401EMAIL_NOT_VALIDATED

    L'adresse e-mail du compte n'a pas encore été vérifiée.

  • 429CREDENTIAL_TEMPORARILY_BLOCKED

    Clé API temporairement bloquée après des violations répétées de la politique.

  • 429IP_TEMPORARILY_BLOCKED

    IP de la requête temporairement bloquée après des violations répétées de la politique.

  • 429TOO_MANY_CONCURRENT_CONNECTIONS

    Trop de requêtes simultanées depuis cette IP. Réessayez dans un instant.

  • 400INVALID_JSON

    Le corps de la requête n'est pas un JSON valide.

  • 400MISSING_FROM

    Le champ from est manquant ou vide.

  • 400INVALID_FROM_FORMAT

    Le champ from doit être une adresse e-mail valide.

  • 400MISSING_SENDERNAME

    Le champ senderName est manquant ou vide.

  • 400INVALID_SENDERNAME_FORMAT

    Le champ senderName contient des caractères invalides.

  • 400MISSING_SUBJECT

    Le champ subject est manquant ou vide.

  • 400MISSING_BODY

    Le champ body est manquant ou vide.

  • 400MISSING_TOADDRESS

    Le champ to est manquant ou vide.

  • 400MISSING_TO

    Le champ to est manquant ou vide.

  • 400INVALID_TOADDRESS

    Une ou plusieurs adresses de destinataire sont mal formées.

  • 400TOADDRESS_LIMIT_EXCEEDED

    Plus de 50 destinataires dans le tableau to.

  • 400INVALID_CCADDRESS

    Une ou plusieurs adresses cc sont mal formées.

  • 400INVALID_BCCADDRESS

    Une ou plusieurs adresses bcc sont mal formées.

  • 400RECIPIENT_LIMIT_EXCEEDED

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

  • 400INVALID_SCHEDULED_AT

    scheduled_at n'est pas une date valide ou est dans le passé.

  • 400INVALID_SENDER_FORMAT

    Le format de l'e-mail de l'expéditeur est invalide.

  • 400HEADER_NOT_ALLOWED

    La clé de l'en-tête personnalisé n'est pas dans la liste autorisée (List-Unsubscribe, List-Id, X-*, etc.).

  • 400INVALID_HEADER_VALUE

    La valeur de l'en-tête contient des caractères invalides (CR/LF interdits).

  • 400DANGEROUS_ATTACHMENT

    Une ou plusieurs pièces jointes ont été bloquées pour des raisons de sécurité.

  • 400INVALID_ATTACHMENT

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

  • 400MISSING_UNSUBSCRIBE_PLACEHOLDER

    unsubscribe vaut true mais le body ne contient aucun placeholder de désinscription ([unsubscribe_url], [unsubscribe], [unsub_url] ou [opt_out_url]).

  • 403ACCOUNT_RESTRICTED

    Le compte est temporairement restreint.

  • 403DAILY_LIMIT

    Limite quotidienne d'envoi d'e-mails atteinte.

  • 403MARKETING_LIMIT_REACHED

    Limite quotidienne marketing du plan gratuit atteinte : 30 e-mails marketing ou de prospection à froid par jour, comptés par destinataire sur une fenêtre glissante de 24 heures. La réponse contient limit, used, recipients et upgradeUrl. Les e-mails transactionnels partent toujours ; rien n'est mis en file d'attente.

  • 403FORBIDDEN_HTML_CONTENT

    Le HTML contient du contenu actif interdit dans les e-mails (script, iframe, form, input, button, embed, object, svg, handlers on*, liens javascript:, meta refresh…). La réponse liste les éléments détectés. Utilisez un <a> stylé au lieu de boutons ou de formulaires.

  • 403SPAM_DETECTED

    Contenu de l'e-mail signalé comme spam. La réponse inclut le quarantine_id et les instructions de libération.

  • 403SENDER_NAME_MISMATCH

    Plusieurs noms d'expéditeur détectés pour la même adresse.

  • 403FOLLOWUP_PATTERN_DETECTED

    Contenu de l'e-mail signalé comme schéma répété de relance suspecte.

  • 403SCAM_PATTERN_DETECTED

    Contenu de l'e-mail signalé comme schéma d'arnaque.

  • 403ACCOUNT_SUSPENDED_SPOOFING

    Compte suspendu après des tentatives répétées d'usurpation de l'en-tête From.

  • 409IDEMPOTENCY_IN_PROGRESS

    Une requête avec la même Idempotency-Key est encore en cours de traitement. Attendez (Retry-After: 1) et réessayez avec la même clé.

  • 422IDEMPOTENCY_KEY_REUSED

    Cette Idempotency-Key a déjà été utilisée avec un autre corps. Utilisez une nouvelle clé pour chaque nouvel e-mail.

  • 500INTERNAL_SERVER_ERROR

    Erreur serveur inattendue. Réessayez.

  • 500PARSE_ERROR

    Échec du traitement du contenu de l'e-mail (échec du parsing MIME).

  • 500PERSIST_FAILED

    Échec de la mise en file de l'e-mail (échec d'écriture en base de données).

  • 503AUTH_UNAVAILABLE

    Impossible de valider la clé API pour le moment. Réessayez.

  • 503UNSUBSCRIBE_UNAVAILABLE

    Service de lien de désinscription temporairement indisponible. Réessayez plus tard.