Annonces3 min de lecture
Nouveaux endpoints API : contacts, événements et webhooks
Gérez vos contacts, interrogez les événements et configurez vos webhooks par programmation grâce aux derniers ajouts à l’API Emailit.
GPar George
Nous venons de livrer trois nouveaux groupes de ressources dans l’API Emailit v2 : Contacts, Events (événements) et Webhooks. Ensemble, ils vous donnent un contrôle complet, par programmation, sur votre carnet de contacts, le suivi des événements et vos intégrations webhook.
Contacts
L’API Contacts vous permet de créer, consulter, modifier et supprimer les contacts de votre espace de travail. Chaque contact comporte une adresse e-mail, un nom et des champs personnalisés facultatifs, et peut être abonné à une ou plusieurs listes de contacts en un seul appel.
Endpoint | Description |
|---|---|
Liste paginée de tous les contacts | |
Récupère un contact par son ID ou son e-mail | |
Crée un contact et l’abonne à des listes | |
Modifie le nom, l’e-mail, les champs personnalisés ou le statut de désinscription | |
Supprime un contact et tous les abonnés associés |
Vous pouvez retrouver un contact par son ID (con_xxx) ou par son adresse e-mail : utilisez l’identifiant le plus pratique pour vous.
{
"email": "john@example.com",
"first_name": "John",
"last_name": "Doe",
"custom_fields": { "company": "Acme" },
"audiences": ["aud_2BxFg7KNqr5M..."]
}Événements
Des événements sont créés automatiquement chaque fois que quelque chose se produit dans votre espace de travail : un e-mail est livré, un contact est créé, un domaine est mis à jour, etc. L’API Events vous donne un accès en lecture seule à ce flux d’activité.
Endpoint | Description |
|---|---|
Liste paginée, avec filtrage par type et payload facultatif | |
Récupère un événement avec toutes ses données |
Vous pouvez filtrer sur un ou plusieurs types d’événements, séparés par des virgules, et activer include_data pour indiquer si le payload complet doit figurer dans les réponses de liste.
GET /v2/events?type=email.accepted,email.delivered&include_data=trueWebhooks
Les webhooks vous permettent de recevoir des appels HTTP en temps réel dès que des événements se produisent. La nouvelle API Webhooks vous donne un contrôle total : vous pouvez créer, modifier, activer, désactiver et supprimer vos endpoints de webhook, le tout via l’API.
Endpoint | Description |
|---|---|
Liste paginée de tous les webhooks | |
Récupère un webhook par son ID | |
Crée un nouvel endpoint de webhook | |
Modifie l’URL, les événements ou l’état d’activation | |
Supprime un webhook par son ID ou son nom |
Vous pouvez vous abonner à des types d’événements précis ou utiliser all_events pour tout recevoir.
{
"name": "Production Webhook",
"url": "https://example.com/webhook",
"events": ["email.accepted", "email.delivered", "email.bounced"]
}Plus de 30 types d’événements sont disponibles pour les e-mails, les domaines, les listes de contacts, les abonnés, les contacts, les modèles, les adresses bloquées et les vérifications d’e-mails. Retrouvez la liste complète dans la documentation Créer un webhook.
Pour commencer
Ces trois API nécessitent une clé API à accès complet. Rendez-vous dans la référence de l’API pour explorer tous les nouveaux endpoints, ou plongez directement dans la documentation indiquée ci-dessus.
