Les endpoints /emails de l’API v2 sont disponibles

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
• Récupérer un e-mail
• Modifier un e-mail programmé
• Annuler un e-mail

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 ou contactez notre équipe support.