API Domaines d’envoi

Gérez les domaines d’envoi de votre organisation. Les domaines d’envoi vous permettent d’envoyer des emails directement via Mailpulse en utilisant votre propre domaine.

Lister les domaines

Récupérez tous les domaines d’envoi configurés pour votre organisation.

Endpoint


GET /api/sending-domains

Exemple de requête


curl -X GET NEXT_PUBLIC_BASE_URL/api/sending-domains \
  -H "x-api-key: your-api-key"

Exemple de réponse


{
  "domains": [
    {
      "id": "clx1234...",
      "domain": "votredomaine.com",
      "status": "verified",
      "records": [
        {
          "type": "MX",
          "name": "send.votredomaine.com",
          "value": "feedback-smtp.us-east-1.amazonses.com",
          "status": "verified",
          "priority": 10
        },
        {
          "type": "TXT",
          "name": "send.votredomaine.com",
          "value": "v=spf1 include:amazonses.com ~all",
          "status": "verified"
        }
      ],
      "createdAt": "2026-02-11T10:00:00.000Z"
    }
  ]
}

Ajouter un domaine

Enregistrez un nouveau domaine d’envoi. Cela crée le domaine dans Resend et retourne les enregistrements DNS à configurer.

Endpoint


POST /api/sending-domains

Corps de la requête

Champ	Type	Requis	Description
`domain`	`string`	Oui	Nom de domaine (ex: `votredomaine.com`)

Exemple de requête


curl -X POST NEXT_PUBLIC_BASE_URL/api/sending-domains \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "votredomaine.com" }'

Exemple de réponse


{
  "id": "clx1234...",
  "domain": "votredomaine.com",
  "status": "pending",
  "records": [
    {
      "type": "MX",
      "name": "send.votredomaine.com",
      "value": "feedback-smtp.us-east-1.amazonses.com",
      "status": "not_started",
      "priority": 10
    },
    {
      "type": "TXT",
      "name": "send.votredomaine.com",
      "value": "v=spf1 include:amazonses.com ~all",
      "status": "not_started"
    },
    {
      "type": "CNAME",
      "name": "resend._domainkey.votredomaine.com",
      "value": "...",
      "status": "not_started"
    }
  ],
  "createdAt": "2026-02-11T10:00:00.000Z"
}

Vérifier un domaine

Déclenchez une vérification DNS pour un domaine d’envoi.

Endpoint


POST /api/sending-domains/verify

Corps de la requête

Champ	Type	Requis	Description
`domainId`	`string`	Oui	ID du domaine à vérifier

Exemple de requête


curl -X POST NEXT_PUBLIC_BASE_URL/api/sending-domains/verify \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{ "domainId": "clx1234..." }'

Exemple de réponse


{
  "id": "clx1234...",
  "domain": "votredomaine.com",
  "status": "verified",
  "records": [...],
  "verified": true
}

Supprimer un domaine

Supprimez un domaine d’envoi de votre organisation.

Endpoint


DELETE /api/sending-domains/:id

Exemple de requête


curl -X DELETE NEXT_PUBLIC_BASE_URL/api/sending-domains/clx1234 \
  -H "x-api-key: your-api-key"

Exemple de réponse


{
  "success": true
}

Configuration DNS

Après l’ajout d’un domaine, vous recevrez des enregistrements DNS à configurer chez votre fournisseur DNS :

Type	Objectif
MX	Gestion des rebonds
TXT (SPF)	Autoriser Mailpulse à envoyer en votre nom
CNAME (DKIM)	Signature d’authentification des emails

La propagation DNS peut prendre jusqu’à 48 heures. Le dashboard vérifie automatiquement le statut de vérification.

Réponses d’erreur

Statut	Description
`400 Bad Request`	Format de domaine invalide ou erreur API Resend
`401 Unauthorized`	Clé API invalide ou manquante
`404 Not Found`	Domaine non trouvé
`409 Conflict`	Domaine déjà ajouté