---
title: "Testez votre intégration e-mail en mode sandbox"
description: "Envoyez de vraies requêtes API et SMTP vers un projet sandbox. Lettermint traite chaque e-mail comme d'habitude, sans jamais le distribuer."
url: "https://lettermint.co/fr/journal-des-modifications/tester-votre-integration-e-mail-en-mode-sandbox"
published: "2026-10-08"
last_updated: "2026-10-08"
---

# Testez votre intégration e-mail en mode sandbox

> Envoyez de vraies requêtes API et SMTP vers un projet sandbox. Lettermint traite chaque e-mail comme d'habitude, sans jamais le distribuer.

Pour tester une intégration e-mail, on envoie souvent quelques
messages à sa propre adresse ou à une adresse jetable. Une ou deux
fois, ce n'est pas un problème. Mais si vous le faites à chaque
modification, les *bounces* et les envois répétés peuvent nuire à la
réputation de votre domaine.

Le mode sandbox règle ce problème. Vous continuez d'envoyer vos
[e-mails transactionnels](https://lettermint.co/fr/fonctionnalites/e-mails-transactionnels)
via l'API ou SMTP comme avant, mais aucun n'arrive dans une boîte de
réception.

## Qu'est-ce que le mode sandbox ?

Le mode sandbox est un réglage propre à chaque projet. Lettermint
accepte et traite chaque e-mail normalement, puis s'arrête juste avant
de le transmettre au serveur de messagerie du destinataire. Les
validations s'appliquent toujours, donc une adresse invalide renvoie
la même erreur qu'en production. Chaque e-mail apparaît ensuite dans
votre tableau de bord.

Les e-mails d'un projet sandbox **ne sont pas décomptés de votre volume
mensuel**. Ils n'apparaissent pas dans vos statistiques, et un *hard
bounce* simulé n'ajoute jamais d'adresse à votre *suppression list*.

![Lettermint Sandbox](https://lettermint.co/content/changelog/lettermint-sandbox.webp)

## Comment ça marche

### Activer le mode sandbox

Lors de la création d'un projet, choisissez **Sandbox** comme
*delivery mode*. Pour un projet existant, utilisez l'interrupteur sous
**Delivery mode** dans les **Settings**. Vos tokens API et vos
identifiants SMTP restent les mêmes, vous n'avez donc rien à modifier
dans votre code.

### Simuler un résultat

Par défaut, chaque e-mail sandbox est marqué comme distribué. Pour
voir comment votre application réagit à un *hard bounce* ou à une
*spam complaint*, ajoutez `sandbox_result` à votre requête API. Vous
envoyez via SMTP ? Utilisez plutôt l'en-tête
`X-Lettermint-Sandbox-Result`.

```bash
curl -X POST "https://api.lettermint.co/v1/send" \
  -H "Content-Type: application/json" \
  -H "x-lettermint-token: lm_project_token" \
  -d '{
    "from": "sender@acme.com",
    "to": ["recipient@acme.com"],
    "subject": "Welcome to Acme",
    "text": "Thanks for signing up.",
    "sandbox_result": "hard_bounced"
  }'
```

### Webhooks

Les
[webhooks](https://lettermint.co/fr/journal-des-modifications/webhooks-pour-equipe-projets-ou-routes)
continuent de fonctionner en mode sandbox, ce qui vous permet de
tester vos handlers de bout en bout. Attention toutefois au réglage de
chaque webhook. Les nouveaux webhooks sont sur **Live** par défaut et
ne transmettent donc pas les *events* sandbox. Passez-les sur
**Sandbox** ou **Both** pour les recevoir pendant vos tests.

## Passer en production

Une fois vos tests terminés, passez le projet sur **Live** et vos
e-mails partent vers les vrais destinataires. Assurez-vous d'abord que
votre domaine est vérifié, car le mode Live n'envoie que depuis un
domaine vérifié.

## Disponible avec Starter, Growth et Pro

Le mode sandbox est inclus dans les formules
[Starter, Growth et Pro](https://lettermint.co/fr/tarifs). Vous l'activez pour n'importe
quel projet depuis votre
[tableau de bord](https://app.lettermint.co). La
[documentation sur le mode sandbox](https://lettermint.co/docs/platform/projects-and-routes/sandbox-mode)
détaille tous les résultats que vous pouvez simuler et explique
comment distinguer les *events* sandbox des *events* live.