# Les endpoints /emails de l’API v2 sont disponibles

> Envoyez, récupérez, modifiez et annulez des e-mails par programmation avec les nouveaux endpoints e-mail de l’API v2.

2026-01-19 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

Nous sommes ravis de vous annoncer que **les endpoints e-mail sont désormais disponibles dans l’API v2** ! Vous pouvez maintenant envoyer et récupérer des e-mails, modifier des e-mails programmés et annuler des e-mails en attente, le tout via notre API REST.

## Nouveaux endpoints

### Envoyer un e-mail

```
POST /v2/emails
```

Envoyez un e-mail à un ou plusieurs destinataires. L’endpoint d’envoi prend en charge :

- **Destinataires multiples** : jusqu’à 50 destinataires (TO, CC et BCC cumulés)
- **Modèles** : utilisez l’alias ou l’ID d’un modèle, avec substitution de variables grâce à la syntaxe `{{variable}}`
- **Pièces jointes** : joignez des fichiers en base64 ou par URL
- **Programmation** : programmez l’envoi au format ISO 8601, en timestamp Unix ou en langage naturel (en anglais), comme « tomorrow at 9am »
- **Suivi** : remplacez les réglages de suivi par défaut du domaine pour les ouvertures et les clics
- **Métadonnées** : ajoutez des paires clé-valeur personnalisées, stockées et renvoyées avec l’e-mail
- **Idempotence** : évitez les envois en double avec l’en-tête `Idempotency-Key`

Lors d’un envoi à plusieurs adresses, chaque destinataire reçoit son propre ID d’e-mail, pour un suivi individuel.

### Récupérer un e-mail

```
GET /v2/emails/{id}
```

Obtenez des informations détaillées sur un e-mail précis, notamment :

- Son statut actuel (en attente, programmé, envoyé, livré, rebondi, annulé)
- Ses en-têtes et son contenu bruts
- Ses réglages de suivi
- Ses métadonnées personnalisées
- Les horodatages de création et de mise à jour

### Modifier un e-mail programmé

```
POST /v2/emails/{id}
```

Reprogrammez un e-mail prévu pour un envoi futur. Vous pouvez changer l’heure d’envoi tant qu’il reste au moins 3 minutes avant son départ.

### Annuler un e-mail

```
POST /v2/emails/{id}/cancel
```

Annulez un e-mail programmé ou en attente avant son envoi. Pour un e-mail programmé, l’annulation doit être demandée au moins 3 minutes avant l’heure d’envoi prévue.

## Limites de débit

Chaque réponse inclut des en-têtes de limite de débit pour vous permettre de suivre votre consommation :

- `ratelimit-limit` : nombre maximal de requêtes par seconde
- `ratelimit-remaining` : requêtes restantes pour la seconde en cours
- `ratelimit-daily-limit` : nombre maximal de requêtes par jour
- `ratelimit-daily-remaining` : requêtes restantes pour la journée

## Documentation

La documentation complète, avec des exemples de code en Node.js, PHP, Python, Ruby, Go, Rust, Java, .NET et cURL, est disponible :

- [Envoyer un e-mail](https://emailit.com/docs/api-reference/emails/send)
- [Récupérer un e-mail](https://emailit.com/docs/api-reference/emails/get)
- [Modifier un e-mail programmé](https://emailit.com/docs/api-reference/emails/update)
- [Annuler un e-mail](https://emailit.com/docs/api-reference/emails/cancel)

## Bientôt : l’API des modèles

Nous travaillons sur l’**API des modèles** (Templates API), qui vous permettra de créer, modifier et gérer vos modèles d’e-mails par programmation. Restez à l’écoute !

## Fin de l’API v1

**Important :** l’API v1 est obsolète et cessera de fonctionner fin février 2026. Si vous utilisez encore l’API v1, migrez vers l’API v2 dès que possible.

Besoin d’aide pour migrer ? Consultez la [documentation de l’API v2](https://emailit.com/docs/api-reference) ou contactez notre équipe support.

---

Source: https://emailit.com/fr/blog/api-v2-emails-endpoints/
