Aller au contenu
Docs

Démarrage rapide

Envoyer votre premier e-mail avec l’API

Vérifiez un domaine, créez une clé API et envoyez votre premier e-mail avec cURL ou un SDK officiel pour Node.js, Python, PHP, Ruby, Go, Java, .NET ou Rust.

Mis à jour le 1 oct. 2026

Ce démarrage rapide vous mène d’un nouveau compte à un e-mail livré en cinq minutes environ, plus le temps nécessaire à votre fournisseur DNS pour publier les enregistrements. Vous allez vérifier un domaine, créer une clé API, envoyer un e-mail et le retrouver dans le tableau de bord.

Avant de commencer

  • Un compte Emailit. Créez-le sur dash.emailit.com.
  • Un domaine auquel vous pouvez ajouter des enregistrements DNS, comme acme.com. Vous pouvez aussi utiliser un sous-domaine, comme mail.acme.com.

Ajouter et vérifier votre domaine

Emailit n’envoie que depuis des domaines que vous avez vérifiés, afin que les serveurs de messagerie des destinataires puissent contrôler que l’e-mail vient bien de vous.

  1. Ajoutez le domaine. Accédez à Email APIDomains, sélectionnez Add domain, saisissez acme.com et sélectionnez Create.

  2. Publiez les enregistrements DNS. La page du domaine liste les enregistrements à ajouter chez votre fournisseur DNS. Copiez les valeurs exactes depuis cette page. Les trois enregistrements obligatoires ressemblent à ceci :

    Type Nom Valeur
    TXT emailit._domainkey.acme.com v=DKIM1; t=s; h=sha256; p=… (votre clé)
    TXT emailit.acme.com v=spf1 include:_spf.emailit.com ~all
    MX emailit.acme.com, priorité 10 feedback-smtp.ffdc-1.emailit.com

    Si votre DNS est hébergé chez Cloudflare, vous pouvez plutôt publier les enregistrements en un clic. Consultez Cloudflare.

  3. Vérifiez le DNS. Sélectionnez Check DNS. Quand SPF, DKIM et Return Path affichent OK, le domaine est Verified. La plupart des fournisseurs publient les enregistrements en quelques minutes, mais cela peut prendre jusqu’à 48 heures.

Sur Pay as you go, un domaine enregistré il y a moins de 30 jours affiche Pending verification jusqu’à ce que l’équipe Emailit l’examine. Pour les détails et les enregistrements facultatifs pour DMARC, le suivi et les e-mails entrants, consultez Ajouter un domaine d’envoi.

Créer une clé API

  1. Ouvrez la page API Keys. Accédez à Email APIAPI Keys et sélectionnez Add API key.

  2. Nommez la clé et choisissez une portée. Saisissez un nom comme Quickstart. Sending Only ne peut qu’envoyer des e-mails. Full Access peut aussi appeler le reste de l’API. Les deux conviennent pour ce démarrage rapide.

  3. Copiez la clé. Sélectionnez Create et copiez la clé. Elle commence par secret_ et n’est affichée qu’une seule fois.

  4. Stockez-la dans une variable d’environnement pour la garder hors de votre code :

    Terminal
    export EMAILIT_API_KEY="secret_••••"

Envoyer un e-mail

Installez le SDK de votre langage, ou utilisez cURL :

Terminal
# cURL is preinstalled on macOS, Linux and Windows 10 or later
curl --version

Envoyez ensuite un e-mail. Utilisez une adresse d’expéditeur sur le domaine que vous avez vérifié, et envoyez-le à l’adresse e-mail avec laquelle vous avez créé votre compte :

Terminal
curl https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Hello from Emailit",
    "html": "<p>This is my first email sent with Emailit.</p>"
  }'

Lire la réponse

Une requête réussie renvoie 200 avec le nouvel e-mail :

JSON
{
  "object": "email",
  "id": "em_2pX7cN4kQ9vLm3RtB8yWd1Zs",
  "token": "2pX7cN4m8FqT1vKz6RbL3HwYd",
  "message_id": "<2pX7cN4m8FqT1vKz6RbL3HwYd@acme.com>",
  "from": "Acme <hello@acme.com>",
  "to": ["ada@example.com"],
  "subject": "Hello from Emailit",
  "status": "accepted",
  "scheduled_at": null,
  "created_at": "2026-10-01T09:30:12.418Z",
  "tracking": { "loads": false, "clicks": false }
}
Champ Signification
id L’ID de l’e-mail. Utilisez-le pour consulter l’e-mail, l’annuler ou le relancer, et pour faire correspondre les événements webhook.
status accepted signifie qu’Emailit a mis l’e-mail en file d’attente pour livraison. Il vaut scheduled si vous avez défini scheduled_at.
message_id L’en-tête Message-ID de l’e-mail.
ids Présent uniquement s’il y a plusieurs destinataires. Associe chaque adresse de destinataire à son propre ID d’e-mail.
tracking Indique si les ouvertures (loads) et les clics sont suivis pour cet e-mail. Le suivi nécessite un sous-domaine de suivi vérifié.

accepted ne signifie pas encore livré. La livraison se fait en arrière-plan, et le statut change au fil de sa progression.

Vérifier dans le tableau de bord

Accédez à Email APIEmails. Votre e-mail se trouve en haut de l’onglet Outgoing. En quelques secondes, son statut passe généralement de accepted à delivered. Ouvrez-le pour voir les en-têtes, le contenu, chaque tentative de livraison avec la réponse du serveur destinataire, et les résultats des contrôles anti-spam.

La requête elle-même apparaît dans Email APILogs, avec le code de statut et les corps de la requête et de la réponse.

Dépannage

Réponse Cause Solution
401 API key required ou Invalid API key L’en-tête Authorization est absent ou la clé est incorrecte Envoyez Authorization: Bearer secret_… avec une clé valide
403 unverified_workspace_recipient L’espace de travail est en mode bac à sable Envoyez à l’adresse e-mail du compte d’un membre de l’espace de travail, ou demandez l’accès production
422 From/Sender domain is not valid or not verified Le domaine d’expéditeur n’est pas vérifié dans cet espace de travail Vérifiez le domaine, ou utilisez une adresse sur un domaine vérifié
403 Domain not authorized La clé Sending Only est limitée à un autre domaine Utilisez une clé pour ce domaine, ou une clé sans restriction
402 Insufficient credits L’espace de travail n’a pas assez de crédits Ajoutez des crédits
429 Rate limit exceeded Trop d’e-mails dans la seconde ou dans la journée Attendez la durée indiquée dans retry-after. Voir Limites de débit.

Étapes suivantes

Recevez les événements de livraison, de rebond et d’ouverture en temps réel.
Concevez-le une fois dans le tableau de bord et envoyez-le par alias avec des variables.
Relancez les requêtes sans risque, sans envoyer deux fois.
Ce qu’il faut vérifier avant d’envoyer à de vrais destinataires.

Cette page vous a-t-elle été utile ?

Merci pour votre retour.

Merci, nous lisons chaque message.