Référence de l’API

L’API Emailit est une API REST servie en HTTPS. Vous envoyez du JSON, vous recevez du JSON, et vous authentifiez chaque requête avec un jeton bearer. Utilisez-la pour envoyer des e-mails et pour gérer tout le reste d’un espace de travail : domaines d’envoi, clés API, contacts, listes de contacts, campagnes, modèles, webhooks et plus encore.

URL de base

Toutes les requêtes sont adressées à l’URL de base de la version 2 :

https://api.emailit.com/v2

Les chemins de cette référence sont relatifs à cette URL. Par exemple, POST /emails signifie POST https://api.emailit.com/v2/emails.

Effectuer votre première requête

Cette requête envoie un e-mail. Remplacez l’expéditeur par une adresse d’un domaine d’envoi vérifié et définissez EMAILIT_API_KEY avec l’une de vos clés API.

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": "Welcome to Acme",
    "html": "<p>Thanks for signing up.</p>"
  }'

import { Emailit } from '@emailit/node';

const emailit = new Emailit(process.env.EMAILIT_API_KEY);

const email = await emailit.emails.send({
  from: 'Acme <hello@acme.com>',
  to: 'ada@example.com',
  subject: 'Welcome to Acme',
  html: '<p>Thanks for signing up.</p>',
});

import os
from emailit import EmailitClient

client = EmailitClient(os.environ["EMAILIT_API_KEY"])

email = client.emails.send({
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Welcome to Acme",
    "html": "<p>Thanks for signing up.</p>",
})

La réponse est le nouvel objet e-mail, avec son ID (em_…) et le statut accepted. Pour toutes les options, consultez Envoyer un e-mail.

Authentification

Transmettez une clé API ou un jeton d’accès OAuth dans l’en-tête Authorization :

Authorization: Bearer secret_••••••••••••••••••••••••••••••••

Les clés API commencent par secret_ et appartiennent à un espace de travail. Une clé a la portée full (tous les endpoints) ou la portée sending (endpoints d’envoi uniquement), et une clé d’envoi peut être limitée à un domaine d’envoi. Les requêtes sans clé valide échouent avec 401. Consultez Authentification.

Requêtes et réponses

• JSON en entrée, JSON en sortie. Envoyez les corps de requête en JSON avec Content-Type: application/json. Un corps qui n’est pas un JSON valide renvoie 400 avec le message Invalid JSON in request body. Le corps de requête ne peut pas dépasser 50 Mo.
• Méthodes. GET lit, POST crée et met à jour, et DELETE supprime. L’API n’utilise ni PUT ni PATCH.
• Objets. Chaque objet possède un champ object qui indique son type (email, domain, api_key, audience, subscriber, contact, …) et un id.
• Horodatages. Les dates sont des chaînes ISO 8601 en UTC, précises à la microseconde, par exemple 2026-10-01T09:30:12.482913Z. Les champs non définis valent null.
• Listes. Les endpoints de liste sont paginés et la plupart acceptent des filtres et un tri. Consultez Pagination et Filtrage et tri.
• Erreurs. Les requêtes en échec renvoient un code de statut 4xx ou 5xx et un corps JSON qui explique le problème. Consultez Erreurs.

ID d’objets

Les ID sont des chaînes composées d’un préfixe de type et de 27 lettres et chiffres, par exemple em_4KYof1ZzXndZE2VPi0DgULiekG8. Ils sont sensibles à la casse et à peu près ordonnés par date de création.

Certaines ressources acceptent aussi un identifiant lisible dans le chemin. Les domaines, les clés API, les listes de contacts, les campagnes et les webhooks acceptent leur nom (GET /domains/acme.com). Les contacts et les adresses bloquées acceptent une adresse e-mail, et les abonnés acceptent l’adresse e-mail du contact. Encodez pour l’URL les noms et les adresses qui contiennent des caractères spéciaux. Les domaines créés avant le passage aux ID dom_ conservent leur ID sd_ ou sed_, et ces ID fonctionnent toujours.

Gestion des versions

La version actuelle est v2 et fait partie de l’URL de base. Les nouveaux champs et endpoints sont ajoutés à v2 sans changement de version : écrivez donc des clients qui ignorent les champs qu’ils ne reconnaissent pas. Consultez Gestion des versions.

Ressources

Pour un tableau unique de tous les endpoints et de la portée qu’ils nécessitent, consultez Tous les endpoints.

SDK

Des bibliothèques officielles encapsulent l’API pour les langages les plus courants. Leur code source est ouvert, sur GitHub.

Webhooks et événements

Plutôt que d’interroger régulièrement l’API pour suivre les changements de statut, enregistrez un webhook : Emailit envoie à votre endpoint des lots d’événements signés au fil de l’eau (livraisons, rebonds, ouvertures, clics, nouveaux contacts et plus encore). Les mêmes événements sont disponibles via Lister les événements. Pour la liste complète, consultez Types d’événements.

Serveur MCP

Le serveur MCP hébergé à l’adresse https://api.emailit.com/mcp permet aux assistants IA comme ChatGPT, Claude, Cursor, Codex et Grok d’appeler cette API pour votre compte : 109 outils couvrent toutes les ressources de cette page. Les assistants se connectent avec OAuth ou utilisent une clé API, avec les mêmes portées. Consultez Serveur MCP et la référence des outils.

Voir aussi