> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dexnotify.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Envoyer un e-mail

> Un e-mail transactionnel, depuis votre domaine.

```bash theme={null}
curl -X POST https://api.dexnotify.com/api/v1/email/messages \
  -H "x-api-key: $DEXNOTIFY_CLE" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: facture-2026-1182" \
  -d '{
    "from": "Votre Marque <factures@votremarque.sn>",
    "to": "awa.diop@exemple.sn",
    "subject": "Votre facture de novembre",
    "html": "<p>Bonjour Awa,</p><p>Votre facture est disponible.</p>",
    "text": "Bonjour Awa, votre facture est disponible."
  }'
```

Portée : `email:send`.

| Champ | Description |
| - | - |
| `from` | `Nom <adresse>` ou `adresse`. Le domaine de l’adresse doit être [vérifié](https://docs.dexnotify.com/email/domaines.md). |
| `to`, `cc`, `bcc` | Une adresse, ou une liste de 50 au plus. Même format que `from`. |
| `replyTo` | Adresse de réponse. |
| `subject` | L’objet. |
| `html`, `text` | Le corps : l’un, l’autre ou les deux (recommandé). 500 000 caractères au plus chacun. |
| `attachments` | 10 pièces jointes au plus : `filename`, `content` en base64, `contentType`. |
| `headers` | En-têtes personnalisés, de la forme `X-…`. |
| `tags` | Paires clé/valeur pour retrouver vos envois dans le journal. |

La réponse rend l’`id` du message, son `status` et les adresses écartées (`suppressed`) :

```json theme={null}
{ "id": "6731…", "status": "queued", "suppressed": [] }
```

## Les adresses écartées

Une adresse de la [liste de suppression](https://docs.dexnotify.com/email/evenements.md#liste-de-suppression) — rebond définitif, plainte, ajout manuel — n’est pas envoyée. Si toutes le sont, le message est `suppressed` et rien ne part.

## Quotas

Les e-mails sont comptés à l’échelle de l’organisation, par mois et par jour selon votre offre. Un quota atteint répond `402`, avec le plafond dans le message. `GET /api/v1/email/overview` rend la consommation face à l’offre.

## Staging

En staging, rien ne part : l’envoi est simulé `delivered`, sans consommer de quota.

> [!TIP]
>
> Pour une newsletter ou une promotion vers vos listes — éditeur visuel, désinscription en un clic, rapport d’ouvertures — utilisez les [campagnes e-mail](https://docs.dexnotify.com/campagnes/introduction.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.