Ajouter un domaine

Avant d'envoyer des e-mails via MailLand, vous devez ajouter et vérifier au moins un domaine d'envoi. Cela prouve que vous êtes propriétaire du domaine et autorise MailLand à envoyer en votre nom.

Ajouter un domaine

POST https://api.mail.land/v1/domains

Add a domain

curl -X POST https://api.mail.land/v1/domains \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "yourdomain.com"
  }'

Réponse

Statut : 201 Created

Domain response

{
  "id": "k3v9x2m8q1w7z4",
  "domain": "yourdomain.com",
  "verificationStatus": "pending",
  "spfStatus": "pending",
  "dkimStatus": "pending",
  "dmarcStatus": "pending",
  "isFullyVerified": false,
  "trackingSubdomain": "track",
  "useCustomTracking": false,
  "bounceSubdomain": "bounce",
  "useCustomBounce": true,
  "inboundEnabled": false,
  "inboundSubdomain": null,
  "mxVerified": false,
  "healthStatus": "unknown",
  "createdAt": "2026-02-17T10:00:00Z",
  "updatedAt": "2026-02-17T10:00:00Z"
}

Champ	Type	Description
`id`	string	ID public du domaine
`domain`	string	Le nom de domaine
`verificationStatus`	enum	`pending`, `verified` ou `failed`
`spfStatus` / `dkimStatus` / `dmarcStatus`	enum	`pending`, `valid` ou `invalid` par enregistrement
`isFullyVerified`	boolean	Propriété vérifiée ET SPF, DKIM et DMARC tous `valid`, requis pour envoyer
`trackingSubdomain` / `bounceSubdomain`	string	Sous-domaines de tracking/rebond, que le domaine personnalisé soit activé ou non
`useCustomTracking` / `useCustomBounce`	boolean	Si le domaine de tracking/rebond personnalisé est activé
`inboundEnabled`	boolean	Si la réception d'e-mails entrants est activée pour ce domaine
`inboundSubdomain`	string \| null	Sous-domaine de l'enregistrement MX entrant ; `null` signifie la racine du domaine
`mxVerified`	boolean	Si l'enregistrement MX entrant est vérifié
`healthStatus`	enum	`unknown`, `healthy`, `warning` ou `critical`
`createdAt`	datetime	Date d'ajout du domaine

Il n'y a pas de jeton de vérification : l'ajout d'un domaine crée l'enregistrement et génère automatiquement sa clé DKIM (sans étape de jeton).

Après avoir ajouté un domaine, vous devez configurer les enregistrements DNS et vérifier la propriété avant de pouvoir envoyer des e-mails. Consultez Configuration DNS pour les enregistrements requis.

Flux de configuration

Ajouter le domaine

Appelez POST /v1/domains avec votre nom de domaine. MailLand crée l'enregistrement du domaine et génère sa clé DKIM.

Obtenir les instructions DNS

Appelez GET /v1/domains/{id}/dns-instructions pour récupérer les enregistrements DNS exacts à créer. Consultez Configuration DNS.

Configurer les enregistrements DNS

Ajoutez les enregistrements SPF, DKIM et DMARC (ainsi que les CNAME optionnels de rebond/tracking si activés) à votre fournisseur DNS.

Vérifier le domaine

Appelez POST /v1/domains/{id}/verify pour déclencher la vérification. MailLand vérifie tous les enregistrements DNS et met à jour le statut du domaine. Consultez Vérification.

Lister les domaines

GET https://api.mail.land/v1/domains

List domains

curl https://api.mail.land/v1/domains \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

List response

{
  "items": [
    {
      "id": "k3v9x2m8q1w7z4",
      "domain": "yourdomain.com",
      "verificationStatus": "verified",
      "spfStatus": "valid",
      "dkimStatus": "valid",
      "dmarcStatus": "valid",
      "isFullyVerified": true,
      "trackingSubdomain": "track",
      "useCustomTracking": false,
      "bounceSubdomain": "bounce",
      "useCustomBounce": false,
      "inboundEnabled": false,
      "inboundSubdomain": null,
      "mxVerified": false,
      "healthStatus": "healthy",
      "createdAt": "2026-02-17T10:00:00Z",
      "updatedAt": "2026-02-17T10:15:00Z"
    }
  ],
  "nextCursor": "eyJ2IjoxLCJzIjoiY3JlYXRlZGF0OmRlc2MiLCJrIjoi...",
  "hasMore": true
}

Obtenir un domaine

GET https://api.mail.land/v1/domains/{id}

Retourne les détails complets du domaine, y compris le statut de vérification et tous les sous-domaines.

Get a domain

curl https://api.mail.land/v1/domains/k3v9x2m8q1w7z4 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Mettre à jour les paramètres du domaine

Personnalisez les sous-domaines de suivi et de rebond, et basculez l'entrant. Autres champs de paramètres : useCustomTracking, useCustomBounce, inboundEnabled, inboundSubdomain. Ces libellés ne prennent effet qu'une fois l'indicateur personnalisé correspondant activé et l'enregistrement vérifié. Activer useCustomBounce efface la vérification de l'enregistrement de rebond, vous devez donc revérifier son CNAME :

PATCH https://api.mail.land/v1/domains/{id}/settings

Update domain settings

curl -X PATCH https://api.mail.land/v1/domains/k3v9x2m8q1w7z4/settings \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "trackingSubdomain": "links",
    "bounceSubdomain": "returns"
  }'

La modification des sous-domaines nécessite la mise à jour de vos enregistrements DNS et la re-vérification du domaine.

Supprimer un domaine

DELETE https://api.mail.land/v1/domains/{id}

Retourne 204 No Content en cas de succès. La suppression d'un domaine :

Révoque toutes les clés DKIM associées au domaine
Arrête tous les envois d'e-mails depuis ce domaine
Supprime le routage de suivi et de rebond

Delete a domain

curl -X DELETE https://api.mail.land/v1/domains/k3v9x2m8q1w7z4 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

La suppression est permanente. Toute clé API limitée à ce domaine ne pourra plus envoyer d'e-mails. Les campagnes ou automatisations actives utilisant ce domaine échoueront.

Réponses d'erreur

Statut	Code	Description
`400`	`VALIDATION_FAILED`	Format de nom de domaine invalide
`400`	`INVALID_REQUEST`	Domaine déjà ajouté (à cet espace de travail ou à un autre)
`400`	`DOMAIN_SUBDOMAIN_EMPTY`	PATCH des paramètres : un champ de sous-domaine a été envoyé vide
`400`	`DOMAIN_SUBDOMAIN_CONFLICT`	PATCH des paramètres : le sous-domaine demandé est déjà utilisé par un autre enregistrement de ce domaine
`404`	`DOMAIN_NOT_FOUND`	L'ID de domaine n'existe pas
`403`	`PLAN_LIMIT_REACHED`	Nombre maximum de domaines atteint pour votre plan

MailLand limite le nombre de domaines d'envoi selon le plan, et la limite diffère d'un plan à l'autre (certains plans sont illimités). Une fois atteinte, l'ajout d'un domaine renvoie 403 PLAN_LIMIT_REACHED. Consultez votre plan actuel dans Facturation.

Étapes suivantes

Configuration DNS : configurer les enregistrements SPF, DKIM et DMARC
Vérification : vérifier la propriété du domaine
Rotation des clés DKIM : gérer les clés de signature DKIM

Ajouter un domaine