Les endpoints API v2 /emails sont maintenant disponibles

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

Nouveaux endpoints

Envoyer un e-mail

POST /v2/emails

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

• Destinataires multiples — Envoyez jusqu’à 50 destinataires (TO, CC, BCC combinés)
• Modèles — Utilisez des alias ou des ID de modèles avec substitution de variables via la syntaxe {{variable}}
• Pièces jointes — Incluez des fichiers via du contenu base64 ou une URL
• Programmation — Programmez des e-mails pour une livraison future en utilisant ISO 8601, des timestamps Unix, ou un langage naturel comme “demain à 9h”
• Suivi — Remplacez les paramètres de suivi par défaut du domaine pour les ouvertures et clics
• Métadonnées — Attachez des paires clé-valeur personnalisées qui sont stockées et renvoyées avec l’e-mail
• Idempotence — Évitez les envois en double avec l’en-tête Idempotency-Key

Chaque destinataire reçoit son propre ID d’e-mail unique pour un suivi individuel lors d’envois à plusieurs adresses.

Récupérer un e-mail

GET /v2/emails/{id}

Récupérez des informations détaillées sur un e-mail spécifique, notamment :

• Statut actuel (en attente, programmé, envoyé, livré, rejeté, annulé)
• En-têtes et contenu bruts de l’e-mail
• Paramètres de suivi
• Métadonnées personnalisées
• Horodatages de création et de mise à jour

Modifier un e-mail programmé

POST /v2/emails/{id}

Reprogrammez un e-mail prévu pour une livraison future. Vous pouvez modifier l’heure programmée tant que l’e-mail est à au moins 3 minutes de son envoi.

Annuler un e-mail

POST /v2/emails/{id}/cancel

Annulez un e-mail programmé ou en attente avant son envoi. Pour les e-mails programmés, 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 que vous puissiez surveiller votre utilisation :

• ratelimit-limit — Nombre maximum de requêtes par seconde
• ratelimit-remaining — Requêtes restantes dans la seconde actuelle
• ratelimit-daily-limit — Nombre maximum de requêtes quotidiennes
• ratelimit-daily-remaining — Requêtes quotidiennes restantes

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 disponible : API Templates

Nous travaillons sur l’API Templates qui vous permettra de créer, modifier et gérer des modèles d’e-mail par programmation. Restez à l’écoute pour cette fonctionnalité passionnante !

Avis de dépréciation de l’API v1

Important : L’API v1 a été dépréciée et cessera de fonctionner à la fin février 2026. Si vous utilisez encore l’API v1, veuillez migrer vers l’API v2 dès que possible.

Besoin d’aide pour migrer ? Consultez notre documentation API v2 ou contactez notre équipe de support.