# 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.

2026-02-17 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

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 |
| --- | --- |
| [Lister les contacts](https://emailit.com/docs/api-reference/contacts/list) | Liste paginée de tous les contacts |
| [Récupérer un contact](https://emailit.com/docs/api-reference/contacts/get) | Récupère un contact par son ID ou son e-mail |
| [Créer un contact](https://emailit.com/docs/api-reference/contacts/create) | Crée un contact et l’abonne à des listes |
| [Modifier un contact](https://emailit.com/docs/api-reference/contacts/update) | Modifie le nom, l’e-mail, les champs personnalisés ou le statut de désinscription |
| [Supprimer un contact](https://emailit.com/docs/api-reference/contacts/delete) | 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.

```json
{
  "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 |
| --- | --- |
| [Lister les événements](https://emailit.com/docs/api-reference/events/list) | Liste paginée, avec filtrage par type et payload facultatif |
| [Récupérer un événement](https://emailit.com/docs/api-reference/events/get) | 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=true
```

## Webhooks

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 |
| --- | --- |
| [Lister les webhooks](https://emailit.com/docs/api-reference/webhooks/list) | Liste paginée de tous les webhooks |
| [Récupérer un webhook](https://emailit.com/docs/api-reference/webhooks/get) | Récupère un webhook par son ID |
| [Créer un webhook](https://emailit.com/docs/api-reference/webhooks/create) | Crée un nouvel endpoint de webhook |
| [Modifier un webhook](https://emailit.com/docs/api-reference/webhooks/update) | Modifie l’URL, les événements ou l’état d’activation |
| [Supprimer un webhook](https://emailit.com/docs/api-reference/webhooks/delete) | 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.

```json
{
  "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](https://emailit.com/docs/api-reference/webhooks/create).

## Pour commencer

Ces trois API nécessitent une clé API à accès complet. Rendez-vous dans la [référence de l’API](https://emailit.com/docs/api-reference/endpoints) pour explorer tous les nouveaux endpoints, ou plongez directement dans la documentation indiquée ci-dessus.

---

Source: https://emailit.com/fr/blog/nouveaux-endpoints-api-contacts-evenements-webhooks/
