Headers de désinscription
Ajoutez des headers List-Unsubscribe à vos e-mails pour que les destinataires (et les fournisseurs comme Gmail et Yahoo) puissent se désinscrire sans signaler votre e-mail comme spam. Cela améliore nettement la délivrabilité des envois en masse et marketing.
https://mail.sendcorex.com/v3.0/sendLes fournisseurs de messagerie recommandent vivement (et parfois exigent) List-Unsubscribe sur tout envoi en masse. L'absence de ce header sur des envois à fort volume peut nuire à l'arrivée en boîte de réception.
Les headers se placent dans l'objet headers de la requête d'envoi. Pour les règles de nommage applicables à tous les autres headers, consultezHeaders personnalisés.
Headers pris en charge
List-UnsubscribefacultatifListe de méthodes de désinscription séparées par des virgules, entre chevrons. Accepte un lien mailto: et un lien https:.
ex.
"<mailto:unsubscribe@yourdomain.com?subject=unsubscribe>,<https://yourdomain.com/unsubscribe?u=123>"List-Unsubscribe-PostfacultatifActive la désinscription en un clic de Gmail/Yahoo. Obligatoire si vous voulez que le bouton « Se désabonner » apparaisse directement dans l'interface de la boîte de réception. Doit valoir exactement :
ex.
"List-Unsubscribe=One-Click"List-IdfacultatifIdentifie la liste de diffusion à laquelle appartient cet e-mail.
ex.
"My List <mylist.yourdomain.com>"
Lien de désinscription automatique
Si vous n'avez pas votre propre système de désinscription, Sendcorex peut générer et gérer le lien de désinscription et le mailto pour vous. Définissez unsubscribe: true dans la requête d'envoi et incluez l'un des placeholders pris en charge dans le corps, à l'endroit où vous voulez insérer le lien.
Placeholders pris en charge
[unsubscribe_url][unsubscribe][unsub_url][opt_out_url]
Utilisez l'un d'eux dans un href (ou n'importe où dans le corps). Sendcorex le remplace par le vrai lien de désinscription de chaque destinataire avant l'envoi.
unsubscribe: true, sans système propre
{
"to": "contact@gmail.com",
"from": "noreply@yourdomain.com",
"senderName": "My App",
"subject": "Welcome aboard!",
"body": "<h1>Welcome!</h1><p>Thanks for signing up.</p><p><a href=\"[unsubscribe]\">Unsubscribe</a></p>",
"replyTo": "support@yourdomain.com",
"unsubscribe": true
}Si unsubscribe: true est défini mais qu'aucun des placeholders pris en charge n'est trouvé dans le corps, la requête échoue avec MISSING_UNSUBSCRIBE_PLACEHOLDER. Consultez laréponse 400.
Liste de contacts
facultatifcontact_list n'est pas obligatoire. Il détermine seulement dans quelle liste le destinataire est enregistré, pour le suivi et l'organisation. Il n'a rien à voir avec le lien de désinscription lui-même.
Sans contact_list (par défaut)
Le contact est automatiquement enregistré dans une liste par défaut nommée "API Contacts". Ce nom ne peut pas être modifié. Vous pouvez la consulter à tout moment dans voslistes de contacts.
{
"to": "contact@gmail.com",
"from": "noreply@yourdomain.com",
"subject": "Welcome aboard!",
"body": "<h1>Welcome!</h1><p><a href=\"[unsubscribe]\">Unsubscribe</a></p>",
"unsubscribe": true
}Avec contact_list (nom personnalisé)
Si la liste n'existe pas encore, elle est créée automatiquement. C'est utile pour séparer les audiences, par exemple une liste par campagne ou par plateforme.
"CRM 2026 - Gmail""Newsletter - Trial Users""Support Tickets"
{
"to": "contact@gmail.com",
"from": "noreply@yourdomain.com",
"subject": "Welcome aboard!",
"body": "<h1>Welcome!</h1><p><a href=\"[unsubscribe]\">Unsubscribe</a></p>",
"unsubscribe": true,
"contact_list": "CRM 2026 - Gmail"
}Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://mail.sendcorex.com/v3.0/send',
{
to: 'contact@gmail.com',
from: 'noreply@yourdomain.com',
senderName: 'My App',
subject: 'Welcome aboard!',
body: '<h1>Welcome!</h1><p>Thanks for signing up.</p><p><a href="[unsubscribe]">Unsubscribe</a></p>',
unsubscribe: true,
contact_list: 'CRM 2026 - Gmail',
headers: {
'List-Id': 'My List <mylist.yourdomain.com>',
'List-Unsubscribe':
'<mailto:unsubscribe@yourdomain.com?subject=unsubscribe>,<https://yourdomain.com/unsubscribe?u=123>',
'List-Unsubscribe-Post': 'List-Unsubscribe=One-Click',
},
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);
const { id } = response.data;Réponse
{
"success": true,
"message": "Email queued successfully",
"code": "EMAIL_QUEUED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"
}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.