API e-mail

L’API e-mail envoie des e-mails depuis votre application via HTTPS plutôt que par une connexion SMTP. Utilisez-la pour les e-mails transactionnels comme les confirmations d’inscription, les réinitialisations de mot de passe, les reçus et les alertes, en particulier si vous voulez des modèles, la programmation, des relances idempotentes et un ID distinct pour chaque destinataire.

Fonctionnement

1. Votre application appelle POST /emails avec une adresse d’expéditeur sur un domaine d’envoiDomaine d’envoiUn domaine qui vous appartient et que vous vérifiez avec des enregistrements DNS, pour qu’Emailit puisse envoyer des e-mails depuis ce domaine avec SPF, DKIM et un return-path personnalisé. vérifié, les destinataires, et le contenu ou un modèle.
2. Emailit valide la requête, débite 1 crédit par destinataire et crée un e-mail par destinataire, chacun avec son propre ID em_.
3. La réponse arrive immédiatement avec le statut accepted, ou scheduled si vous avez fixé une heure d’envoi. La livraison se fait en arrière-plan.
4. Emailit signe le message avec DKIM pour votre domaine, effectue les contrôles anti-spam et le livre. En cas d’échec temporaire, Emailit réessaie pendant environ 21 heures.
5. Chaque changement de statut apparaît dans Email API›Emails et est envoyé à vos webhooks.

URL de base et authentification

Une clé Full Access peut appeler tous les endpoints. Une clé Sending Only peut envoyer, reprogrammer, annuler, relancer et transférer des e-mails, et vous pouvez la restreindre à un seul domaine d’envoi. Pour plus de détails, consultez Authentification.

Envoyer un e-mail

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, Ada.</p>",
    "text": "Thanks for signing up, Ada."
  }'

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, Ada.</p>',
  text: 'Thanks for signing up, Ada.',
});

console.log(email.id);

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, Ada.</p>",
    "text": "Thanks for signing up, Ada.",
})

$emailit = Emailit::client(getenv('EMAILIT_API_KEY'));

$email = $emailit->emails()->send([
    'from' => 'Acme <hello@acme.com>',
    'to' => 'ada@example.com',
    'subject' => 'Welcome to Acme',
    'html' => '<p>Thanks for signing up, Ada.</p>',
    'text' => 'Thanks for signing up, Ada.',
]);

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

{
  "object": "email",
  "id": "em_33VtK8mRq1xZp7LwN4cY2bHsDfa",
  "token": "33VtK8m4XcPq2RwZ7nLb1YsTgHd",
  "message_id": "<33VtK8m4XcPq2RwZ7nLb1YsTgHd@acme.com>",
  "from": "Acme <hello@acme.com>",
  "to": ["ada@example.com"],
  "subject": "Welcome to Acme",
  "status": "accepted",
  "scheduled_at": null,
  "created_at": "2026-10-01T09:30:12.418203Z",
  "tracking": { "loads": false, "clicks": false }
}

Les nouveaux espaces de travail démarrent en mode bac à sable et ne peuvent envoyer qu’aux adresses e-mail des comptes des membres de l’espace de travail. Demandez l’accès production avant d’envoyer à qui que ce soit d’autre.

Ce que vous pouvez faire

Limites

Les limites de débit comptent les destinataires : une requête vers 10 destinataires consomme 10 unités de votre quota par seconde et de votre quota quotidien. Les espaces de travail Pro et Business bénéficient de hausses automatiques selon leur santé d’envoi, et tout espace de travail peut demander davantage depuis la carte Sending Limits de la page d’accueil du tableau de bord. Consultez Limites et Limites de débit.

Crédits

Chaque destinataire coûte 1 crédit, et les adresses to, cc et bcc comptent toutes. Si l’espace de travail n’a pas assez de crédits pour tous les destinataires, la requête échoue avec 402 et rien n’est envoyé. Les relances et les transferts sont facturés comme de nouveaux envois.

Pour savoir comment les crédits inclus et achetés sont utilisés, consultez Crédits.

Étapes suivantes