Planifier un e-mail
Utilisez le même endpoint d'envoi avec le paramètre scheduled_at pour différer la livraison. Accepte les dates ISO 8601 ou le langage naturel. L'e-mail reste annulable jusqu'à son envoi.
https://mail.sendcorex.com/v3.0/sendConservez l'id renvoyé. Vous en aurez besoin pourannuler l'e-mail avant son envoi.
Paramètre supplémentaire
scheduled_atstringfacultatifnouveauQuand envoyer l'e-mail. Accepte le format ISO 8601 ou le langage naturel. Doit être dans le futur.
ex.
"in 1 hour" · "tomorrow at 9am" · "2026-08-05T11:52:01Z"
Tous les autres paramètres sont identiques à ceux de Envoyer un e-mail.
Langage naturel
N'importe lequel de ces formats fonctionne pour scheduled_at.
"in 1 hour""in 30 minutes""tomorrow at 9am""Friday at 3pm ET""next Monday at 8am""2026-08-05T11:52:01Z"
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://mail.sendcorex.com/v3.0/send',
{
to: 'user@example.com',
from: 'noreply@yourdomain.com',
senderName: 'My App',
subject: 'Your weekly digest',
body: '<p>Here is what happened this week...</p>',
scheduled_at: 'tomorrow at 9am',
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);
// Save the id: you need it to cancel the email before it is sent
const { id, ids, scheduledAt, recipients } = response.data;
console.log('Scheduled for ' + scheduledAt + ' (id: ' + id + ')');Réponse
{
"success": true,
"message": "Email scheduled successfully",
"code": "EMAIL_SCHEDULED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"ids": [
{ "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
],
"scheduledAt": "2026-04-26T09:00:00.000Z",
"recipients": 1
}Erreurs
Tous les codes d'erreur →Les erreurs renvoient un objet JSON avec error et code.
- 401
MISSING_AUTH_HEADERAucun en-tête Authorization n'est présent.
- 401
INVALID_API_KEYLa clé API est invalide ou révoquée.
- 401
ACCOUNT_BLOCKEDLe compte a été bloqué.
- 401
NO_CREDITS_LEFTCrédits e-mail insuffisants pour tous les destinataires. Chaque adresse dans to, cc et bcc utilise 1 crédit.
- 401
DOMAIN_NOT_VALIDATEDDomaine de l'expéditeur non vérifié.
- 401
LISTED_SPAM_HAUSLe domaine de l'expéditeur est listé sur Spamhaus.
- 401
ISP_DOMAIN_BLOCKEDL'envoi depuis des domaines connus (gmail.com, outlook.com, etc.) n'est pas autorisé.
- 401
FROM_HEADER_DOMAIN_MISMATCHDomaine de l'en-tête From non autorisé pour cet expéditeur.
- 401
USER_NOT_FOUNDUtilisateur introuvable.
- 401
MISSING_USER_PRIVILEGESPrivilèges utilisateur manquants.
- 401
EMAIL_CREDITS_NOT_FOUNDErreur lors de la récupération des crédits e-mail.
- 401
EMAIL_NOT_VALIDATEDL'adresse e-mail du compte n'a pas encore été vérifiée.
- 429
CREDENTIAL_TEMPORARILY_BLOCKEDClé API temporairement bloquée après des violations répétées de la politique.
- 429
IP_TEMPORARILY_BLOCKEDIP de la requête temporairement bloquée après des violations répétées de la politique.
- 429
TOO_MANY_CONCURRENT_CONNECTIONSTrop de requêtes simultanées depuis cette IP. Réessayez dans un instant.
- 400
INVALID_JSONLe corps de la requête n'est pas un JSON valide.
- 400
MISSING_FROMLe champ from est manquant ou vide.
- 400
INVALID_FROM_FORMATLe champ from doit être une adresse e-mail valide.
- 400
MISSING_SENDERNAMELe champ senderName est manquant ou vide.
- 400
INVALID_SENDERNAME_FORMATLe champ senderName contient des caractères invalides.
- 400
MISSING_SUBJECTLe champ subject est manquant ou vide.
- 400
MISSING_BODYLe champ body est manquant ou vide.
- 400
MISSING_TOADDRESSLe champ to est manquant ou vide.
- 400
MISSING_TOLe champ to est manquant ou vide.
- 400
INVALID_TOADDRESSUne ou plusieurs adresses de destinataire sont mal formées.
- 400
TOADDRESS_LIMIT_EXCEEDEDPlus de 50 destinataires dans le tableau to.
- 400
INVALID_CCADDRESSUne ou plusieurs adresses cc sont mal formées.
- 400
INVALID_BCCADDRESSUne ou plusieurs adresses bcc sont mal formées.
- 400
RECIPIENT_LIMIT_EXCEEDEDto, cc et bcc réunis comptent plus de 50 destinataires uniques.
- 400
INVALID_SCHEDULED_ATscheduled_at n'est pas une date valide ou est dans le passé.
- 400
INVALID_SENDER_FORMATLe format de l'e-mail de l'expéditeur est invalide.
- 400
HEADER_NOT_ALLOWEDLa clé de l'en-tête personnalisé n'est pas dans la liste autorisée (List-Unsubscribe, List-Id, X-*, etc.).
- 400
INVALID_HEADER_VALUELa valeur de l'en-tête contient des caractères invalides (CR/LF interdits).
- 400
DANGEROUS_ATTACHMENTUne ou plusieurs pièces jointes ont été bloquées pour des raisons de sécurité.
- 400
INVALID_ATTACHMENTLe contenu d'une pièce jointe n'est pas un base64 valide.
- 400
MISSING_UNSUBSCRIBE_PLACEHOLDERunsubscribe vaut true mais le body ne contient aucun placeholder de désinscription ([unsubscribe_url], [unsubscribe], [unsub_url] ou [opt_out_url]).
- 403
ACCOUNT_RESTRICTEDLe compte est temporairement restreint.
- 403
DAILY_LIMITLimite quotidienne d'envoi d'e-mails atteinte.
- 403
MARKETING_LIMIT_REACHEDLimite 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.
- 403
FORBIDDEN_HTML_CONTENTLe 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.
- 403
SPAM_DETECTEDContenu de l'e-mail signalé comme spam. La réponse inclut le quarantine_id et les instructions de libération.
- 403
SENDER_NAME_MISMATCHPlusieurs noms d'expéditeur détectés pour la même adresse.
- 403
FOLLOWUP_PATTERN_DETECTEDContenu de l'e-mail signalé comme schéma répété de relance suspecte.
- 403
SCAM_PATTERN_DETECTEDContenu de l'e-mail signalé comme schéma d'arnaque.
- 403
ACCOUNT_SUSPENDED_SPOOFINGCompte suspendu après des tentatives répétées d'usurpation de l'en-tête From.
- 409
IDEMPOTENCY_IN_PROGRESSUne 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é.
- 422
IDEMPOTENCY_KEY_REUSEDCette Idempotency-Key a déjà été utilisée avec un autre corps. Utilisez une nouvelle clé pour chaque nouvel e-mail.
- 500
INTERNAL_SERVER_ERRORErreur serveur inattendue. Réessayez.
- 500
PARSE_ERRORÉchec du traitement du contenu de l'e-mail (échec du parsing MIME).
- 500
PERSIST_FAILEDÉchec de la mise en file de l'e-mail (échec d'écriture en base de données).
- 503
AUTH_UNAVAILABLEImpossible de valider la clé API pour le moment. Réessayez.
- 503
UNSUBSCRIBE_UNAVAILABLEService de lien de désinscription temporairement indisponible. Réessayez plus tard.