Accueil / API email
API email : envoyer, suivre, relancer sans doublon.
Une API HTTPS documentée, avec une spécification OpenAPI et des clés de test.
Ce qui est disponible
POST /api/v1/transactional/sendpour envoyer.GET /api/v1/messages/{id}pour lire un statut.- Validation d’un message sans l’envoyer.
- Webhooks signés pour recevoir les événements.
- Compatibilité avec une partie des routes
/v3de Brevo. - SDK Node et Python :
npm install vaemail,pip install vaemail. Pas de SDK PHP : cURL suffit.
Tester sans risque
Une clé vae_test_ se demande sans compte et reste valable 24 heures. Avec elle, aucun message ne part.
Spécification : OpenAPI 3.1. Il n’existe pas de collection Postman.
Les limites
Les débits et les plafonds dépendent de votre compte et de votre clé. Un 202 signifie « en file ». Pour relancer après un délai dépassé, réutilisez la même Idempotency-Key.
Tarif
Le transactionnel et les campagnes partagent le même volume mensuel. Grille complète : 300 emails par mois gratuits sans carte bancaire, puis 39,50 € HT par mois jusqu’à 50 000 emails.
Pour commencer
Guides : Node, Python, PHP et cURL. Codes d’erreur : la liste.
Questions fréquentes
Peut-on limiter ce que fait une clé ?
Oui. Une clé nommée porte ses droits, ses plafonds, ses domaines et ses adresses IP autorisés. Elle se révoque et se remplace depuis votre espace.
Comment vérifier un webhook ?
Chaque envoi est signé. La méthode est décrite dans la documentation des webhooks.
Un agent IA peut-il utiliser l’API ?
Oui, voir API et agents. Les envois de masse restent soumis à une confirmation humaine.