Domaines

Ajoutez des domaines d’envoi, consultez leurs enregistrements DNS et leur statut de vérification, et vérifiez-les.

URL de basehttps://api.emailit.com/v2Authentification Erreurs Limites de débit

POST/domains
GET/domains/{id}
POST/domains/{id}/verify
POST/domains/{id}
GET/domains
DEL/domains/{id}

Créer un domaine

Ajoute un domaine d’envoi et renvoie les enregistrements DNS à publier.

POST/domains

Nécessite une clé API full. Emailit génère une clé DKIM de 2 048 bits pour le domaine. Publiez les enregistrements de dns_records chez votre fournisseur DNS, puis appelez Vérifier un domaine. Vous pouvez envoyer depuis le domaine une fois qu’il est vérifié. Consultez Ajouter un domaine et Enregistrements DNS.

Le nombre de domaines dépend de votre forfait : 3 sur Pay as you go (25 après votre premier achat de crédits), 100 sur Pro et 1 000 sur Business. Déclenche l’événement domain.created.

Paramètres du corps

namestringobligatoire

Le domaine depuis lequel envoyer, par exemple acme.com ou mail.acme.com, sans http://, https:// ni www.. Enregistré en minuscules. Vos adresses from doivent utiliser exactement ce domaine.

tracking_keystring

Le nom du sous-domaine utilisé pour le CNAME de suivi des ouvertures et des clics. Vaut go par défaut, ce qui donne go.acme.com. Lettres, chiffres et traits d’union.

inbound_keystring

Le nom du sous-domaine utilisé pour la réception des e-mails. Vaut inbound par défaut, ce qui donne inbound.acme.com. Lettres, chiffres et traits d’union.

dmarc_reportsbooleanpar défaut : false

Collecte les rapports DMARC du domaine. Emailit crée une adresse de réception des rapports et l’ajoute à l’enregistrement DMARC suggéré. Disponible sur les forfaits Pro, Business et Custom. Consultez DMARC.

track_loadsbooleanpar défaut : false

Doit valoir false à la création d’un domaine. Activez le suivi avec Mettre à jour un domaine une fois le CNAME de suivi vérifié.

track_clicksbooleanpar défaut : false

Comme track_loads, pour le suivi des clics.

Les anciens indicateurs outgoing, incoming et use_for_any sont acceptés pour compatibilité et n’ont aucun effet.

Réponse

Renvoie 201 avec l’objet domaine, dns_records compris. Un nouveau domaine a le statut pending, ou pending_review sur Pay as you go jusqu’à sa première vérification DNS.

POST/domains

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const domain = await emailit.domains.create({ name: 'acme.com' });

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

domain = client.domains.create({"name": "acme.com"})

PHP

$emailit = Emailit::client('your_api_key');

$domain = $emailit->domains()->create(['name' => 'acme.com']);

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

domain = client.domains.create(name: "acme.com")

import "github.com/emailit/emailit-go/v2"

client := emailit.NewClient("your_api_key")

domain, err := client.Domains.Create(&emailit.CreateDomainRequest{Name: "acme.com"})

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let domain = emailit.domains.create(emailit::types::CreateDomainParams::new("acme.com")).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject domain = emailit.domains().create(DomainCreateParams.builder().setName("acme.com").build());

using Emailit;

var emailit = new EmailitClient("your_api_key");

var domain = emailit.Domains.Create(new DomainCreateOptions { Name = "acme.com" });

PHP

use Emailit\Laravel\Facades\Emailit;

$domain = Emailit::domains()->create(['name' => 'acme.com']);

Terminal

curl https://api.emailit.com/v2/domains \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "acme.com"}'

Terminal

curl https://api.emailit.com/v2/domains \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "acme.com",
    "tracking_key": "links",
    "inbound_key": "reply",
    "dmarc_reports": true
  }'

JSON

{
  "object": "domain",
  "id": "dom_4K468YrjOkR1wwdhqiO0G9XEUey",
  "name": "acme.com",
  "verification_token": "vt_4KY8weirBN9sxnfbIt78tsFWteY",
  "verification_method": "dns",
  "verified_at": null,
  "manually_verified_at": null,
  "manual_review_required": false,
  "verification_status": "pending",
  "dkim_identifier_string": "emailit",
  "dns_checked_at": null,
  "spf_status": "pending",
  "spf_error": null,
  "dkim_status": "pending",
  "dkim_error": null,
  "mx_status": "pending",
  "mx_error": null,
  "return_path_status": "pending",
  "return_path_error": null,
  "dmarc_status": "pending",
  "dmarc_error": null,
  "tracking_status": "pending",
  "tracking_error": null,
  "tracking_key": null,
  "inbound_status": "pending",
  "inbound_error": null,
  "inbound_key": null,
  "track_loads": 0,
  "track_clicks": 0,
  "dmarc_reports": false,
  "dmarc_address": null,
  "created_at": "2026-10-01T09:12:03.551208Z",
  "updated_at": "2026-10-01T09:12:03.551208Z",
  "dns_records": [
    {
      "required": true,
      "type": "MX",
      "name": "emailit.acme.com",
      "value": "feedback-smtp.ffdc-1.emailit.com",
      "priority": 10,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit.acme.com",
      "value": "v=spf1 include:_spf.emailit.com ~all",
      "priority": null,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit._domainkey.acme.com",
      "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAx3kQ...IDAQAB;",
      "priority": null,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": false,
      "type": "TXT",
      "name": "_dmarc.acme.com",
      "value": "v=DMARC1; p=none;",
      "priority": null,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": false,
      "type": "CNAME",
      "name": "go.acme.com",
      "value": "go.emailitmail.com",
      "priority": null,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": false,
      "type": "MX",
      "name": "inbound.acme.com",
      "value": "inbound.emailitmail.com",
      "priority": 10,
      "ttl": "auto",
      "status": "pending",
      "error": null
    }
  ]
}

JSON

{
  "error": "The domain must be in apex format (e.g., domain.com) without http://, https://, or www."
}

JSON

{
  "error": "plan_required",
  "required_plan": "pro"
}

JSON

{
  "error": "Domain with this name already exists",
  "existing": {
    "object": "domain",
    "id": "dom_4K468YrjOkR1wwdhqiO0G9XEUey",
    "name": "acme.com"
  }
}

JSON

{
  "error": "Pay as you go includes 3 domain(s)."
}

JSON

{
  "error": "Tracking requires a verified custom CNAME. New messages are not rewritten to a shared tracking URL."
}

Récupérer un domaine

Récupère un domaine d’envoi avec son statut de vérification et ses enregistrements DNS.

GET/domains/{id}

Nécessite une clé API full. Les statuts des enregistrements reflètent la dernière vérification DNS, exécutée lorsque vous appelez Vérifier un domaine et automatiquement une fois par jour.

Paramètres de chemin

idstringobligatoire

L’ID du domaine (dom_…, ou sd_… et sed_… pour les domaines plus anciens) ou le nom de domaine, par exemple acme.com.

Réponse

Renvoie l’objet domaine.

objectstring

Toujours domain.

idstring

L’ID du domaine.

namestring

Le nom de domaine.

verification_statusstring

verified lorsque le domaine peut envoyer. pending tant que SPF, DKIM ou le return-path ne sont pas encore corrects. pending_review sur Pay as you go lorsque le domaine doit faire l’objet d’un examen manuel par Emailit avant de pouvoir être vérifié, par exemple parce qu’il a été enregistré il y a moins de 30 jours.

verified_atstring | null

Date de la dernière vérification DNS réussie, ou null si le domaine n’est pas vérifié. Une vérification en échec réinitialise ce champ.

manual_review_requiredboolean

Indique si le domaine attend l’examen manuel d’Emailit.

manually_verified_atstring | null

Date à laquelle Emailit a approuvé manuellement le domaine, ou null.

dns_checked_atstring | null

Date de la dernière vérification des enregistrements DNS.

spf_status, dkim_status, return_path_statusstring

Statut des trois enregistrements obligatoires : pending (pas encore vérifié), ok, missing ou invalid. Les trois doivent être ok pour que le domaine soit vérifié.

mx_statusstring

Identique à return_path_status.

dmarc_statusstring

Statut de l’enregistrement DMARC : pending, ok, missing, invalid ou error. Facultatif pour la vérification.

tracking_statusstring

Statut du CNAME de suivi. Doit être ok avant que vous puissiez activer le suivi.

inbound_statusstring

Statut de l’enregistrement MX de réception. Nécessaire pour recevoir des e-mails sur le domaine.

spf_error, dkim_error, mx_error, return_path_error, dmarc_error, tracking_error, inbound_errorstring | null

Le problème détecté sur chaque enregistrement après une vérification en échec, ou null.

tracking_keystring | null

Le nom du sous-domaine de suivi, ou null pour la valeur par défaut go.

inbound_keystring | null

Le nom du sous-domaine de réception, ou null pour la valeur par défaut inbound.

track_loadsinteger

1 si le suivi des ouvertures est activé par défaut pour les e-mails de ce domaine, 0 sinon.

track_clicksinteger

1 si le suivi des clics est activé par défaut, 0 sinon.

dmarc_reportsboolean

Indique si Emailit collecte les rapports DMARC du domaine.

dmarc_addressstring | null

L’adresse qui reçoit les rapports DMARC, ou null lorsque dmarc_reports est désactivé.

verification_token, verification_method, dkim_identifier_stringstring

Détails internes de vérification. verification_method vaut dns et dkim_identifier_string est le sélecteur DKIM, emailit.

created_at, updated_atstring

Date d’ajout et de dernière modification du domaine.

dns_recordsobject[]

Les enregistrements à publier. Chacun comporte type (MX, TXT ou CNAME), name, value, priority (pour les enregistrements MX), ttl (auto), required (indique s’il est nécessaire à la vérification), ainsi que son status et son error actuels.

Enregistrement	Type	Nom	Valeur	Obligatoire
Return-path	MX	`emailit.acme.com`	`feedback-smtp.ffdc-1.emailit.com`, priorité 10	Oui
SPF	TXT	`emailit.acme.com`	`v=spf1 include:_spf.emailit.com ~all`	Oui
DKIM	TXT	`emailit._domainkey.acme.com`	`v=DKIM1; t=s; h=sha256; p=…`	Oui
DMARC	TXT	`_dmarc.acme.com`	`v=DMARC1; p=none;`, plus les adresses de rapport lorsque `dmarc_reports` est activé	Non
Suivi	CNAME	`go.acme.com`	`go.emailitmail.com`	Non
Réception	MX	`inbound.acme.com`	`inbound.emailitmail.com`, priorité 10	Non

GET/domains/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const domain = await emailit.domains.get('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

domain = client.domains.get("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

PHP

$emailit = Emailit::client('your_api_key');

$domain = $emailit->domains()->get('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

domain = client.domains.get("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

domain, err := client.Domains.Get("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let domain = emailit.domains.get("dom_4K468YrjOkR1wwdhqiO0G9XEUey").await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject domain = emailit.domains().get("dom_4K468YrjOkR1wwdhqiO0G9XEUey");

using Emailit;

var emailit = new EmailitClient("your_api_key");

var domain = emailit.Domains.Get("dom_4K468YrjOkR1wwdhqiO0G9XEUey");

PHP

use Emailit\Laravel\Facades\Emailit;

$domain = Emailit::domains()->get('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Terminal

curl https://api.emailit.com/v2/domains/dom_4K468YrjOkR1wwdhqiO0G9XEUey \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JSON

{
  "object": "domain",
  "id": "dom_4K468YrjOkR1wwdhqiO0G9XEUey",
  "name": "acme.com",
  "verification_token": "vt_4KY8weirBN9sxnfbIt78tsFWteY",
  "verification_method": "dns",
  "verified_at": "2026-10-01T03:00:12.000000Z",
  "manually_verified_at": null,
  "manual_review_required": false,
  "verification_status": "verified",
  "dkim_identifier_string": "emailit",
  "dns_checked_at": "2026-10-01T03:00:12.000000Z",
  "spf_status": "ok",
  "spf_error": null,
  "dkim_status": "ok",
  "dkim_error": null,
  "mx_status": "ok",
  "mx_error": null,
  "return_path_status": "ok",
  "return_path_error": null,
  "dmarc_status": "ok",
  "dmarc_error": null,
  "tracking_status": "ok",
  "tracking_error": null,
  "tracking_key": null,
  "inbound_status": "invalid",
  "inbound_error": "queryMx ENOTFOUND inbound.acme.com",
  "inbound_key": null,
  "track_loads": 1,
  "track_clicks": 1,
  "dmarc_reports": true,
  "dmarc_address": "4KXUJdXRVlVgbkWQm4GHLy8BleP@dmarc.emailitmail.com",
  "created_at": "2026-09-14T08:02:51.000000Z",
  "updated_at": "2026-10-01T03:00:12.000000Z",
  "dns_records": [
    {
      "required": true,
      "type": "MX",
      "name": "emailit.acme.com",
      "value": "feedback-smtp.ffdc-1.emailit.com",
      "priority": 10,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit.acme.com",
      "value": "v=spf1 include:_spf.emailit.com ~all",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit._domainkey.acme.com",
      "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAx3kQ...IDAQAB;",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": false,
      "type": "TXT",
      "name": "_dmarc.acme.com",
      "value": "v=DMARC1; p=none; rua=mailto:4KXUJdXRVlVgbkWQm4GHLy8BleP@dmarc.emailitmail.com; ruf=mailto:4KXUJdXRVlVgbkWQm4GHLy8BleP@dmarc.emailitmail.com;",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": false,
      "type": "CNAME",
      "name": "go.acme.com",
      "value": "go.emailitmail.com",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": false,
      "type": "MX",
      "name": "inbound.acme.com",
      "value": "inbound.emailitmail.com",
      "priority": 10,
      "ttl": "auto",
      "status": "invalid",
      "error": "queryMx ENOTFOUND inbound.acme.com"
    }
  ]
}

JSON

{
  "error": "Domain not found"
}

Vérifier un domaine

Interroge immédiatement les enregistrements DNS du domaine, enregistre le résultat et renvoie le domaine avec ses nouveaux statuts.

POST/domains/{id}/verify

Nécessite une clé API full. Appelez-le après avoir publié les enregistrements fournis par Créer un domaine, puis chaque fois que vous les modifiez. La propagation des modifications DNS peut prendre un certain temps : si un enregistrement affiche missing, patientez quelques minutes et relancez.

Le domaine passe à verified lorsque les trois enregistrements obligatoires sont ok :

SPF : un enregistrement TXT sur emailit.<domain> qui inclut _spf.emailit.com.
DKIM : un enregistrement TXT sur emailit._domainkey.<domain> contenant la clé publique du domaine.
Return-path : un seul enregistrement MX sur emailit.<domain> pointant vers feedback-smtp.ffdc-1.emailit.com.

Sur Pay as you go, un domaine enregistré il y a moins de 30 jours obtient plutôt pending_review, et Emailit l’examine manuellement. Les enregistrements DMARC, de suivi et de réception sont également vérifiés, mais n’ont pas d’incidence sur la vérification.

Emailit revérifie également chaque domaine une fois par jour. Si un enregistrement obligatoire n’est plus valide, le domaine n’est plus vérifié, les envois depuis ce domaine échouent et le propriétaire de l’espace de travail reçoit un e-mail. Consultez Vérification des domaines.

Paramètres de chemin

idstringobligatoire

L’ID du domaine ou le nom de domaine.

Réponse

Renvoie l’objet domaine avec le résultat de cette vérification dans verification_status, dans chaque champ *_status et *_error, et dans dns_records. Cette réponse n’inclut pas dmarc_reports ni dmarc_address ; lisez-les avec Récupérer un domaine.

POST/domains/{id}/verify

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const domain = await emailit.domains.verify('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

domain = client.domains.verify("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

PHP

$emailit = Emailit::client('your_api_key');

$domain = $emailit->domains()->verify('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

domain = client.domains.verify("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

domain, err := client.Domains.Verify("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let domain = emailit.domains.verify("dom_4K468YrjOkR1wwdhqiO0G9XEUey").await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject domain = emailit.domains().verify("dom_4K468YrjOkR1wwdhqiO0G9XEUey");

using Emailit;

var emailit = new EmailitClient("your_api_key");

var domain = emailit.Domains.Verify("dom_4K468YrjOkR1wwdhqiO0G9XEUey");

PHP

use Emailit\Laravel\Facades\Emailit;

$domain = Emailit::domains()->verify('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Terminal

curl -X POST https://api.emailit.com/v2/domains/dom_4K468YrjOkR1wwdhqiO0G9XEUey/verify \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JSON

{
  "object": "domain",
  "id": "dom_4K468YrjOkR1wwdhqiO0G9XEUey",
  "name": "acme.com",
  "verification_token": "vt_4KY8weirBN9sxnfbIt78tsFWteY",
  "verification_method": "dns",
  "verified_at": null,
  "manually_verified_at": null,
  "manual_review_required": false,
  "dkim_identifier_string": "emailit",
  "dns_checked_at": "2026-10-01T09:20:41.000000Z",
  "spf_status": "ok",
  "spf_error": null,
  "dkim_status": "missing",
  "dkim_error": "queryTxt ENOTFOUND emailit._domainkey.acme.com",
  "mx_status": "ok",
  "mx_error": null,
  "return_path_status": "ok",
  "return_path_error": null,
  "dmarc_status": "error",
  "dmarc_error": "queryTxt ENOTFOUND _dmarc.acme.com",
  "tracking_status": "invalid",
  "tracking_error": "queryCname ENOTFOUND go.acme.com",
  "tracking_key": null,
  "inbound_status": "invalid",
  "inbound_error": "queryMx ENOTFOUND inbound.acme.com",
  "inbound_key": null,
  "track_loads": 0,
  "track_clicks": 0,
  "created_at": "2026-10-01T09:12:03.000000Z",
  "updated_at": "2026-10-01T09:20:41.000000Z",
  "dns_records": [
    {
      "required": true,
      "type": "MX",
      "name": "emailit.acme.com",
      "value": "feedback-smtp.ffdc-1.emailit.com",
      "priority": 10,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit.acme.com",
      "value": "v=spf1 include:_spf.emailit.com ~all",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit._domainkey.acme.com",
      "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAx3kQ...IDAQAB;",
      "priority": null,
      "ttl": "auto",
      "status": "missing",
      "error": "queryTxt ENOTFOUND emailit._domainkey.acme.com"
    },
    {
      "required": false,
      "type": "TXT",
      "name": "_dmarc.acme.com",
      "value": "v=DMARC1; p=none;",
      "priority": null,
      "ttl": "auto",
      "status": "error",
      "error": "queryTxt ENOTFOUND _dmarc.acme.com"
    },
    {
      "required": false,
      "type": "CNAME",
      "name": "go.acme.com",
      "value": "go.emailitmail.com",
      "priority": null,
      "ttl": "auto",
      "status": "invalid",
      "error": "queryCname ENOTFOUND go.acme.com"
    },
    {
      "required": false,
      "type": "MX",
      "name": "inbound.acme.com",
      "value": "inbound.emailitmail.com",
      "priority": 10,
      "ttl": "auto",
      "status": "invalid",
      "error": "queryMx ENOTFOUND inbound.acme.com"
    }
  ],
  "verification_status": "pending"
}

JSON

{
  "error": "Domain not found"
}

Mettre à jour un domaine

Met à jour les paramètres d’un domaine d’envoi. Seuls les champs que vous envoyez sont modifiés.

POST/domains/{id}

Nécessite une clé API full. Déclenche l’événement domain.updated.

Paramètres de chemin

idstringobligatoire

L’ID du domaine ou le nom de domaine.

Paramètres du corps

track_loadsboolean

Active ou désactive par défaut le suivi des ouvertures pour les e-mails de ce domaine. L’activation nécessite un CNAME de suivi vérifié (tracking_status vaut ok). Consultez Domaine de suivi personnalisé.

track_clicksboolean

Active ou désactive par défaut le suivi des clics. Même condition que pour track_loads.

tracking_keystring | null

Un nouveau nom de sous-domaine pour le CNAME de suivi, ou null pour la valeur par défaut go. Le modifier remet tracking_status à pending : publiez le nouveau CNAME et vérifiez à nouveau le domaine.

inbound_keystring | null

Un nouveau nom de sous-domaine pour la réception des e-mails, ou null pour la valeur par défaut inbound. Le modifier remet inbound_status à pending.

dmarc_reportsboolean

Collecte les rapports DMARC du domaine. L’activation ajoute une adresse de réception des rapports à l’enregistrement DMARC suggéré : mettez ensuite à jour votre enregistrement _dmarc. Forfaits Pro, Business et Custom uniquement. La désactivation conserve l’adresse pour plus tard.

namestring

Un nouveau nom de domaine. Les enregistrements DNS passent au nouveau nom : publiez-les sur ce domaine et vérifiez-le à nouveau avant d’envoyer depuis celui-ci.

Les anciens indicateurs outgoing, incoming et use_for_any sont acceptés et n’ont aucun effet. Les champs inconnus sont ignorés. Une requête sans aucun de ces champs renvoie 400.

Réponse

Renvoie l’objet domaine mis à jour, dns_records compris.

POST/domains/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const domain = await emailit.domains.update('dom_4K468YrjOkR1wwdhqiO0G9XEUey', { track_clicks: false });

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

domain = client.domains.update("dom_4K468YrjOkR1wwdhqiO0G9XEUey", {"track_clicks": False})

PHP

$emailit = Emailit::client('your_api_key');

$domain = $emailit->domains()->update('dom_4K468YrjOkR1wwdhqiO0G9XEUey', ['track_clicks' => false]);

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

domain = client.domains.update("dom_4K468YrjOkR1wwdhqiO0G9XEUey", track_clicks: false)

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

domain, err := client.Domains.Update("dom_4K468YrjOkR1wwdhqiO0G9XEUey", &emailit.UpdateDomainRequest{TrackClicks: false})

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let domain = emailit.domains.update("dom_4K468YrjOkR1wwdhqiO0G9XEUey", emailit::types::UpdateDomainParams { track_clicks: Some(false), ..Default::default() }).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject domain = emailit.domains().update("dom_4K468YrjOkR1wwdhqiO0G9XEUey", DomainUpdateParams.builder().setTrackClicks(false).build());

using Emailit;

var emailit = new EmailitClient("your_api_key");

var domain = emailit.Domains.Update("dom_4K468YrjOkR1wwdhqiO0G9XEUey", new DomainUpdateOptions { TrackClicks = false });

PHP

use Emailit\Laravel\Facades\Emailit;

$domain = Emailit::domains()->update('dom_4K468YrjOkR1wwdhqiO0G9XEUey', ['track_clicks' => false]);

Terminal

curl -X POST https://api.emailit.com/v2/domains/dom_4K468YrjOkR1wwdhqiO0G9XEUey \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"track_clicks": false}'

Terminal

curl -X POST https://api.emailit.com/v2/domains/acme.com \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"track_loads": true, "track_clicks": true}'

JSON

{
  "object": "domain",
  "id": "dom_4K468YrjOkR1wwdhqiO0G9XEUey",
  "name": "acme.com",
  "verification_token": "vt_4KY8weirBN9sxnfbIt78tsFWteY",
  "verification_method": "dns",
  "verified_at": "2026-10-01T03:00:12.000000Z",
  "manually_verified_at": null,
  "manual_review_required": false,
  "verification_status": "verified",
  "dkim_identifier_string": "emailit",
  "dns_checked_at": "2026-10-01T03:00:12.000000Z",
  "spf_status": "ok",
  "spf_error": null,
  "dkim_status": "ok",
  "dkim_error": null,
  "mx_status": "ok",
  "mx_error": null,
  "return_path_status": "ok",
  "return_path_error": null,
  "dmarc_status": "ok",
  "dmarc_error": null,
  "tracking_status": "ok",
  "tracking_error": null,
  "tracking_key": null,
  "inbound_status": "invalid",
  "inbound_error": "queryMx ENOTFOUND inbound.acme.com",
  "inbound_key": null,
  "track_loads": 1,
  "track_clicks": 0,
  "dmarc_reports": false,
  "dmarc_address": null,
  "created_at": "2026-09-14T08:02:51.000000Z",
  "updated_at": "2026-10-01T10:44:20.000000Z",
  "dns_records": [
    {
      "required": true,
      "type": "MX",
      "name": "emailit.acme.com",
      "value": "feedback-smtp.ffdc-1.emailit.com",
      "priority": 10,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit.acme.com",
      "value": "v=spf1 include:_spf.emailit.com ~all",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit._domainkey.acme.com",
      "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAx3kQ...IDAQAB;",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": false,
      "type": "TXT",
      "name": "_dmarc.acme.com",
      "value": "v=DMARC1; p=none;",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": false,
      "type": "CNAME",
      "name": "go.acme.com",
      "value": "go.emailitmail.com",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": false,
      "type": "MX",
      "name": "inbound.acme.com",
      "value": "inbound.emailitmail.com",
      "priority": 10,
      "ttl": "auto",
      "status": "invalid",
      "error": "queryMx ENOTFOUND inbound.acme.com"
    }
  ]
}

JSON

{
  "error": "No valid fields provided for update. Provide at least one of: name, outgoing, incoming, use_for_any, track_loads, track_clicks, tracking_key, inbound_key, dmarc_reports"
}

JSON

{
  "error": "plan_required",
  "required_plan": "pro"
}

JSON

{
  "error": "Domain not found"
}

JSON

{
  "error": "Another domain with this name already exists"
}

JSON

{
  "error": "Tracking requires a verified custom CNAME. New messages are not rewritten to a shared tracking URL."
}

Lister les domaines

Renvoie une page de domaines d’envoi, du plus récent au plus ancien, avec le nombre de domaines autorisés par votre forfait.

GET/domains

Nécessite une clé API full. Les éléments de la liste n’incluent pas dns_records ; utilisez Récupérer un domaine pour les obtenir.

Paramètres de requête

pageintegerpar défaut : 1

La page à renvoyer.

limitintegerpar défaut : 10

Nombre de domaines par page, de 1 à 100.

searchstring

Recherche insensible à la casse sur le nom de domaine.

matchstringpar défaut : all

all ou or. Mode de combinaison des filtres ci-dessous.

orderstring

Une clé de filtre selon laquelle trier.

directionstring

asc ou desc.

Filtres

Ajoutez des filtres sous la forme key.condition=value, par exemple dkim_status.exact=ok. Consultez Filtrage et tri.

Clé	Type	Valeurs et remarques
`name`	chaîne
`created_at`	date
`spf_status`	énumération	`ok`, `missing`, `invalid`
`dkim_status`	énumération	`ok`, `missing`, `invalid`
`return_path_status`	énumération	`ok`, `missing`, `invalid`

Chaque clé est aussi une clé de tri.

Réponse

dataobject[]

Les objets domaine de cette page, sans dns_records.

next_page_urlstring | null

Chemin de la page suivante, ou null. Consultez Pagination.

previous_page_urlstring | null

Chemin de la page précédente, ou null.

domain_limitinteger | null

Nombre de domaines d’envoi autorisés par votre forfait, ou null s’il n’y a pas de limite.

domain_countinteger

Nombre de domaines d’envoi de l’espace de travail, toutes pages confondues.

plan_namestring | null

Le nom de votre forfait, par exemple Pay as you go ou Pro.

GET/domains

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const domains = await emailit.domains.list();

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

domains = client.domains.list()

PHP

$emailit = Emailit::client('your_api_key');

$domains = $emailit->domains()->list();

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

domains = client.domains.list

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

domains, err := client.Domains.List(nil)

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let domains = emailit.domains.list(None).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject domains = emailit.domains().list();

using Emailit;

var emailit = new EmailitClient("your_api_key");

var domains = emailit.Domains.List();

PHP

use Emailit\Laravel\Facades\Emailit;

$domains = Emailit::domains()->list();

Terminal

curl https://api.emailit.com/v2/domains \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Terminal

curl -G https://api.emailit.com/v2/domains \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -d dkim_status.not_exact=ok \
  -d spf_status.not_exact=ok \
  -d match=or

JSON

{
  "data": [
    {
      "object": "domain",
      "id": "dom_4K468YrjOkR1wwdhqiO0G9XEUey",
      "name": "acme.com",
      "verification_token": "vt_4KY8weirBN9sxnfbIt78tsFWteY",
      "verification_method": "dns",
      "verified_at": "2026-10-01T03:00:12.000000Z",
      "manually_verified_at": null,
      "manual_review_required": false,
      "verification_status": "verified",
      "dkim_identifier_string": "emailit",
      "dns_checked_at": "2026-10-01T03:00:12.000000Z",
      "spf_status": "ok",
      "spf_error": null,
      "dkim_status": "ok",
      "dkim_error": null,
      "mx_status": "ok",
      "mx_error": null,
      "return_path_status": "ok",
      "return_path_error": null,
      "dmarc_status": "ok",
      "dmarc_error": null,
      "tracking_status": "ok",
      "tracking_error": null,
      "tracking_key": null,
      "inbound_status": "invalid",
      "inbound_error": "queryMx ENOTFOUND inbound.acme.com",
      "inbound_key": null,
      "track_loads": 1,
      "track_clicks": 1,
      "dmarc_reports": true,
      "dmarc_address": "4KXUJdXRVlVgbkWQm4GHLy8BleP@dmarc.emailitmail.com",
      "created_at": "2026-09-14T08:02:51.000000Z",
      "updated_at": "2026-10-01T03:00:12.000000Z"
    }
  ],
  "next_page_url": null,
  "previous_page_url": null,
  "domain_limit": 100,
  "domain_count": 1,
  "plan_name": "Pro"
}

Supprimer un domaine

Supprime définitivement un domaine d’envoi.

DELETE/domains/{id}

Nécessite une clé API full. Après la suppression, les envois depuis le domaine échouent avec Domain not verified, et les clés API limitées à ce domaine ne peuvent plus envoyer. La clé DKIM du domaine, son historique de santé d’envoi et toute connexion Cloudflare enregistrée sont également supprimés. Les e-mails déjà envoyés restent dans vos logs. Déclenche l’événement domain.deleted.

Pour envoyer à nouveau depuis ce domaine, recréez-le. Il reçoit une nouvelle clé DKIM : vous devrez donc mettre à jour l’enregistrement DKIM.

Paramètres de chemin

idstringobligatoire

L’ID du domaine ou le nom de domaine.

Réponse

objectstring

Toujours domain.

idstring

L’ID du domaine supprimé.

namestring

Le nom de domaine.

deletedboolean

Toujours true.

DELETE/domains/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

await emailit.domains.delete('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

client.domains.delete("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

PHP

$emailit = Emailit::client('your_api_key');

$emailit->domains()->delete('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

client.domains.delete("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

err := client.Domains.Delete("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

emailit.domains.delete("dom_4K468YrjOkR1wwdhqiO0G9XEUey").await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

emailit.domains().delete("dom_4K468YrjOkR1wwdhqiO0G9XEUey");

using Emailit;

var emailit = new EmailitClient("your_api_key");

emailit.Domains.Delete("dom_4K468YrjOkR1wwdhqiO0G9XEUey");

PHP

use Emailit\Laravel\Facades\Emailit;

Emailit::domains()->delete('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Terminal

curl -X DELETE https://api.emailit.com/v2/domains/dom_4K468YrjOkR1wwdhqiO0G9XEUey \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JSON

{
  "object": "domain",
  "id": "dom_4K468YrjOkR1wwdhqiO0G9XEUey",
  "name": "acme.com",
  "deleted": true
}

JSON

{
  "error": "Domain not found"
}