Référence de l'API
Codes d'erreur
Tous les codes d'erreur que l'API peut renvoyer, avec leur statut HTTP et la marche à suivre. L'envoi et la réception utilisent des formats d'erreur différents.
Envoyer un e-mail
Les erreurs renvoient un objet JSON avec error, code et responseTime. Voir Envoyer un e-mail.
- 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
SHARED_DOMAIN_REQUIRES_PAID_PLANCe domaine d'envoi partagé est réservé aux plans payants. La réponse liste dans allowedDomains les domaines partagés que vous pouvez utiliser, ainsi que upgradeUrl. Utilisez l'un d'eux ou votre propre domaine vérifié.
- 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.
Limites du plan gratuit
Sur le plan gratuit, le marketing et la prospection à froid sont limités à 30 e-mails par jour, comptés par destinataire (un e-mail à 5 personnes compte pour 5) sur une fenêtre glissante de 24 heures. Les e-mails transactionnels ne sont pas concernés. Au-delà, la requête est refusée et rien n'est mis en file d'attente : renvoyez quand la fenêtre se libère, ou passez à un plan payant.
MARKETING_LIMIT_REACHEDRenvoyé par /v3.0/send quand cet e-mail dépasserait la limite marketing du plan gratuit. used correspond à ce qui a déjà été compté sur les dernières 24 heures et recipients à ce que cet e-mail ajouterait.
{
"code": "MARKETING_LIMIT_REACHED",
"error": "Daily marketing limit reached for the free plan (30/30, 2 recipients in this email). Transactional emails still go out.",
"limit": 30,
"used": 30,
"recipients": 2,
"upgradeUrl": "https://app.sendcorex.com/dashboard/billing"
}SHARED_DOMAIN_REQUIRES_PAID_PLANRenvoyé lorsque vous créez un expéditeur sur un domaine partagé réservé aux plans payants. allowedDomains liste les domaines partagés accessibles à votre plan ; votre propre domaine vérifié fonctionne toujours.
{
"code": "SHARED_DOMAIN_REQUIRES_PAID_PLAN",
"error": "This shared domain is available on paid plans. Use inboxtaken.com or your own domain.",
"allowedDomains": ["inboxtaken.com"],
"upgradeUrl": "https://app.sendcorex.com/dashboard/billing"
}Règles complètes : Politique d'utilisation acceptable — Plan gratuit
Réception : erreurs HTTP
Elles rejettent toute la requête. Le body est { "type": "ERROR", "code": "...", "message": "..." }. En cas de RATE_LIMITED, attendez le nombre de secondes indiqué dans l'en-tête Retry-After.
- 400
INVALID_JSONThe body is not {"commands":[...]} or has more than 20 commands.
- 401
MISSING_AUTH_HEADERNo Authorization header was sent.
- 401
INVALID_TOKENThe token is malformed, unknown or revoked.
- 401
TOKEN_EXPIREDThe access token has expired. Call Refresh Token and repeat the request.
- 401
INVALID_REFRESH_TOKENThe refresh token is invalid, expired, revoked or already used. Generate a new token in the dashboard.
- 429
RATE_LIMITEDMore than 15 requests/s or 15 in flight for the same IP + mailbox. Wait the number of seconds in Retry-After.
- 503
AUTH_UNAVAILABLEAuthentication is temporarily unavailable. Try again.
Réception : erreurs de commande
Elles reviennent dans le résultat de la commande, avec HTTP 200 : une commande en échec n'arrête donc pas les autres de la même requête. Vérifiez results[].type. Voir Exécuter des commandes.
- CMD
INVALID_ARGSA required argument is missing or invalid.
- CMD
UNKNOWN_COMMANDThe command name does not exist.
- CMD
NOT_FOUNDThe message, thread or folder does not exist for this token.
- CMD
INVALID_CURSORThe cursor is malformed or belongs to another account or folder.
- CMD
ALREADY_EXISTSA folder or label with this name already exists.
- CMD
NOT_IN_TRASHdelete only works on messages in Trash or Spam. Use move to send a message to Trash first.
- CMD
SENDER_NOT_FOUNDThe sender behind the token is not registered.
- CMD
SENDER_NO_DOMAINThe sender behind the token has no domain.
- CMD
NO_CREDITSThe account has fewer email credits than recipients (1 credit per copy).
- CMD
NO_RECIPIENTThe conversation has no recipient to reply to.
- CMD
INVALID_RULEThe rule is not valid. The message says which condition or action and why.
- CMD
LIMITThe mailbox reached the limit (100 rules, 200 templates or 100 labels).
- CMD
INVALID_TOADDRESSThe to address is not a valid email.
- CMD
INVALID_CCADDRESSOne of the cc addresses is not a valid email.
- CMD
INVALID_BCCADDRESSOne of the bcc addresses is not a valid email.
- CMD
INVALID_RECIPIENTThe recipient is missing or not a valid email.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc and bcc together have more than 50 addresses.
- CMD
INVALID_ATTACHMENTAn attachment content is not valid base64.
- CMD
FILE_BLOCKEDA file was blocked by the security scan.
- CMD
ATTACHMENTS_TOO_LARGEThe attachments of the email add up to more than 25 MB, or the mailbox already has 500 MB of uploads waiting to be sent.
- CMD
TOO_MANY_OPEN_COMPOSESThe mailbox has 50 emails with uploads that were not sent yet. Send them, or wait for the unused ones to be deleted after 48 hours.
- CMD
ATTACHMENT_MISSINGAn uploaded attachment no longer exists (uploads not sent within 48 hours, and not used by a draft or scheduled email, are deleted). Upload it again.
- CMD
ALREADY_SENTThe compose_uid belongs to an email that was already sent.
- CMD
INVALID_TIMEsend_at is missing, less than 1 minute away or more than 1 year away.
- CMD
MISSING_SUBJECTA new email needs a subject.
- CMD
MISSING_TARGETReply and forward need the original email, and it must still exist.
- CMD
DRAFT_NOT_FOUNDThe draft does not exist anymore: it was sent, deleted, or saved again (every save returns a new draft_id).
- CMD
NOT_SCHEDULEDThe email was already sent or canceled.
- CMD
SEND_FAILEDThe send was refused. The email is back in Drafts and the message says why.
- CMD
NO_UNSUBSCRIBEThe email has no List-Unsubscribe header.
- CMD
RECIPIENT_UNSUBSCRIBEDOne or more recipients unsubscribed from this mailbox. `recipients` lists them: remove them or send again with `unsubscribe: false`.
- CMD
PAID_PLAN_REQUIREDMore than one address in `to` needs a paid plan.
- CMD
TOO_MANY_RECIPIENTS`to` has more than 30 addresses.
- CMD
INVALID_AUDIENCEThe audience is not valid: unknown group, a segment of another mailbox or a message this mailbox didn’t send.
- CMD
AUDIENCE_OVER_LIMITThe audience has more people than you can send to (up to 5,000 per email and your daily limit). `total` and `allowed` say how many.
- CMD
EMPTY_AUDIENCENobody in this audience right now.
- CMD
BEST_TIME_NEEDS_AUDIENCE`best_time` needs an `audience` and `mode: new`.
- CMD
READ_ONLY_ACCESSThe token or app has Read only access and the command writes. In the attachment upload route it is HTTP 403.
- CMD
INTERNALServer error. The detail is only written to the server log.