Référence
Journal des modifications : Clés API
Clés API : nouvelles fonctionnalités, améliorations et corrections.
octobre 2026
Nouveauté
Suivi des événements : événements d’espace de travail et événements personnalisés
Suivi des événementsClés APIWebhooks
Vous pouvez désormais envoyer vos propres événements à côté de ceux qu’Emailit enregistre, comme une commande, un changement de forfait ou la consultation d’un produit. Ils se gèrent dans les nouveaux onglets Workspace events et Tracking de Email API > Events.
- Deux portées. Les événements d’espace de travail (
w:<name>) sont déclarés au préalable avec des propriétés typées, et Emailit rejette les événements qui ne correspondent pas. Les événements personnalisés (c:<name>) acceptent n’importe quel objet JSON. Le journal des événements dispose d’un filtre Scope, et l’endpoint Lister les événements d’un paramètrescope. - Depuis vos serveurs. Envoyer un événement enregistre un événement, et Envoyer des événements par lot jusqu’à 100. Ces endpoints fonctionnent avec les nouvelles clés API Events Only, qui peuvent envoyer des événements, mais ni lire de données ni envoyer d’e-mails.
- Depuis votre site web. Le script de suivi envoie des événements avec une clé de suivi publique que vous pouvez limiter à vos propres sites.
identifyrattache les événements d’un visiteur à un contact. - Contacts et webhooks. Les événements apparaissent dans l’Activity log du contact. Les webhooks reçoivent les types que vous choisissez, ou tous les événements d’espace de travail ou personnalisés avec
w:*etc:*. - API et MCP. Les API des événements d’espace de travail et des clés de suivi, ainsi que l’outil
send-eventet les outils d’événements d’espace de travail du groupe d’outils MCPevents. - Forfaits. Le suivi des événements et le script de suivi sont inclus dans les forfaits Pro, Business et Custom. Pro peut utiliser 100 types d’événements, Business 1 000, et Custom n’a pas de limite. Consultez Limites.
Consultez Suivi des événements.
- Deux portées. Les événements d’espace de travail (
septembre 2026
Correction
Corrections de compatibilité de l’API v2
API RESTClés APIAPI e-mailDomaines d’envoi
- Les clés API créées avant l’introduction du préfixe
secret_sont de nouveau acceptées sur/v2. - Récupérer un e-mail renvoie l’objet e-mail complet, y compris
object,frometto. - Les réponses des domaines renvoient
track_loadsettrack_clickssous la forme0ou1, comme documenté.
- Les clés API créées avant l’introduction du préfixe
Modification
Les clés API d’envoi uniquement sont limitées aux endpoints d’envoi
Les clés d’envoi uniquement pouvaient auparavant lister et récupérer des e-mails et appeler certains autres endpoints de lecture. Elles sont désormais limitées à Envoyer un e-mail et aux actions sur un e-mail existant : reprogrammer, annuler, relancer et transférer. Les autres endpoints rejettent les clés d’envoi.
Si votre intégration lit aussi des e-mails, des domaines ou d’autres ressources, utilisez une clé à accès complet pour ces appels. Consultez Clés API.
octobre 2025
Nouveauté
API v2
API RESTClés APIDomaines d’envoiListes de contactsAdresses bloquées
Les clés API remplacent les identifiants. Une clé a la portée
fullousending, une clé d’envoi peut être restreinte à un seul domaine d’envoi, et vous pouvez gérer les clés via l’API. L’API v1 est restée disponible pendant votre migration.Consultez la référence de l’API.