Domaines

Envoyez depuis votre propre domaine, authentifié

Ajoutez un domaine, publiez les enregistrements que nous vous donnons et commencez à envoyer avec DKIM, SPF, DMARC et Return-Path alignés. Les enregistrements sont formatés pour votre panneau DNS.

  • Commandes JSON
  • DKIM 2048
  • Changement de clé sans interruption
  • Validation automatique
  • Hosts adaptés à votre registrar
POSThttps://g.sendcorex.com/v1/domaindomain:*

Fonctionnement

Enregistrements prêts à coller

Nous détectons où votre DNS est hébergé et écrivons chaque host comme ce panneau l'attend. Les longues valeurs DKIM sont aussi découpées pour les panneaux qui l'exigent.

Validé automatiquement

Chaque Get Domain vérifie le DNS en direct. Dès que le Return-Path et le DKIM sont trouvés, le domaine est validé et vous recevez un email.

Des clés qui vieillissent bien

Les nouveaux domaines reçoivent un DKIM 2048 bits. Les anciennes clés 1024 bits passent à 2048 sur un nouveau sélecteur, l'ancienne continuant de signer jusqu'à ce que le nouvel enregistrement soit actif.

Premiers pas

Seule la clé est nécessaire avant votre première requête.

  1. 1

    Créez une API key avec des scopes de domaine

    Dans le dashboard, ouvrez Developers → API Keys et donnez à la clé domain:read et domain:create. N'ajoutez domain:delete que si elle doit vraiment supprimer.

    Le token du webmail ne fonctionne pas ici. Cette API utilise l'API key du dashboard.

  2. 2

    Ajoutez le domaine

    Add Domain crée la clé DKIM et renvoie les enregistrements à publier.

  3. 3

    Publiez et vérifiez

    Créez les enregistrements dans votre panneau DNS, puis appelez Get Domain jusqu'à ce que validated soit true. Ensuite, créez-y des senders.

Le domaine

Add Domain et Get Domain renvoient le domaine sous cette forme.

{
  "domain": "news.acme.com",
  "validated": false,
  "has_mx": false,
  "has_spf": false,
  "has_dkim": false,
  "has_dmarc": false,
  "has_return_path": false,
  "description": null,
  "dkim_key_size": 2048,
  "dkim_deprecated": false,
  "dkim_upgrade_pending": false,
  "created_at": "2026-10-21T03:02:15.441Z",
  "updated_at": "2026-10-21T03:02:15.441Z",
  "registrar": "cloudflare",
  "dns_records": {
    "spf": {
      "type": "TXT",
      "host": "news.acme.com",
      "value": "v=spf1 include:smtp.emailsbit.com ~all"
    },
    "dkim": {
      "type": "TXT",
      "host": "sendcorex._domainkey.news",
      "value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu1SU1LfVLPHCozMxH2Mo4lgOEePzNm0tRgeLezV6ffAt0gunVTLw7onLRnrq0/IzW7yWR7QkrmBL7jTKEn5u+qKhbwKfBstIs+bMY2Zkp18gnTxKLxoS2tFczGkPLPgizskuemMghRniWaoLcyehkd3qqGElvW/VDL5AaWTg0nLVkjRo9z+40RQzuVaE8AkAFmxZzow3x+VJYKdjykkJ0iT9wCS0DRTXu269V264Vf/3jvredZiKRkgwlL9xNAwxXFg0x/XFw005UWVRIkdgcKWTjpBP2dPwVZ4WWC+9aGVd+Gyn1o0CLelf4rEjGoXbAAEgAqeGUxrcIlbjXfbcmwIDAQAB",
      "split_value": "\"v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu1SU1LfVLPHCozMxH2Mo4lgOEePzNm0tRgeLezV6ffAt0gunVTLw7onLRnrq0/IzW7yWR7QkrmBL7jTKEn5u+qKhbwKfBstIs+bMY2Zkp18gnTxKLxoS2tFczGkPLPgizskuemMghRniWaoLcyehkd3qqGElvW/VDL5AaWTg0nLVkjRo9z+40RQzuVaE8AkAF\" \"mxZzow3x+VJYKdjykkJ0iT9wCS0DRTXu269V264Vf/3jvredZiKRkgwlL9xNAwxXFg0x/XFw005UWVRIkdgcKWTjpBP2dPwVZ4WWC+9aGVd+Gyn1o0CLelf4rEjGoXbAAEgAqeGUxrcIlbjXfbcmwIDAQAB\""
    },
    "mx": {
      "type": "MX",
      "host": "news.acme.com",
      "value": "bounce.emailsbit.com",
      "priority": 0
    },
    "return_path": {
      "type": "CNAME",
      "host": "bounces.news",
      "value": "bounce.emailsbit.com"
    },
    "dmarc": {
      "type": "TXT",
      "host": "_dmarc.news",
      "value": "v=DMARC1; p=none; rua=mailto:dmarc@bounces.news.acme.com"
    }
  },
  "spf_duplicate": false,
  "spf_duplicate_records": [],
  "dkim": {
    "version": 2,
    "key_size": 2048,
    "selector": "sendcorex",
    "deprecated": false,
    "upgrade_pending": false,
    "pending": null,
    "previous_selector": null,
    "keep_old_record_until": null,
    "just_upgraded": false
  }
}
validated

true dès que les enregistrements Return-Path et DKIM sont trouvés. Seuls les domaines validés peuvent avoir des senders.

dns_records

SPF, DKIM, MX, Return-Path et DMARC, chacun avec type, host et value. Return-Path et DKIM sont obligatoires.

registrar

Où votre DNS est hébergé. Détermine si host est relatif (Cloudflare, Namecheap…) ou le nom complet (GoDaddy…).

dkim

La clé utilisée, sa taille et toute mise à niveau en cours.

Votre première requête

Ajoutez un sous-domaine pour vos newsletters. Remplacez SENDCOREX_API_KEY par votre API key.

curl -X POST 'https://g.sendcorex.com/v1/domain' \
  -H "Authorization: $SENDCOREX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "commands": [
    { "command": "add_domain", "args": { "domain": "news.acme.com" } }
  ]
}'

Vous recevez les enregistrements à publier. Publiez-les, puis appelez get_domain avec le même domaine jusqu'à ce que validated soit true. La même requête en 8 langages se trouve dans Add Domain.

Tâches courantes

Intégrez vos clients dans votre application

Ajoutez leur domaine depuis votre propre interface, affichez les enregistrements et interrogez Get Domain jusqu'à ce qu'il passe au vert.

En attente du DNS

Confiez le DNS à quelqu'un d'autre

Envoyez par email les enregistrements exacts à l'équipe IT ou à l'agence qui gère le domaine.

Send DNS Instructions

Mettez à niveau les anciennes clés 1024 bits

Trouvez les domaines avec dkim_deprecated et passez-les à 2048 bits sans une minute d'échec DKIM.

Fonctionnement de la mise à niveau

Envoyez avant que votre domaine soit prêt

Créez un sender sur un domaine partagé déjà vérifié par nos soins, et passez au vôtre plus tard.

List Free Domains

Référence complète

Tout ce qui est marqué CMD est une commande envoyée via POST /v1/domain, jusqu'à 10 par requête.