Lister les contacts avec l'API Brevo
Liste les contacts, du plus récent au plus ancien par défaut, avec filtre optionnel par liste, date ou attribut. La réponse contient contacts et count ; paginez avec limit et offset.
- Identifiant
- brevo_list_contacts
L'appel
POST https://connect.reportei.com/api/tools/brevo_list_contacts/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"listIds": []
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| listIds | array | Non | Only the contacts of these lists, from List contact lists. |
| modifiedSince | string | Non | Only the contacts modified after this date-time, for example 2026-01-31T00:00:00.000Z. |
| createdSince | string | Non | Only the contacts created after this date-time, for example 2026-01-31T00:00:00.000Z. |
| filter | string | Non | Filter on an attribute with the equals operator, for example equals(FIRSTNAME,"Ana"). |
| sort | string | Non | Order of creation. The default is desc.Valeurs : asc, desc |
| limit | integer | Non | Contacts per page, up to 1000. The default is 50. |
| offset | integer | Non | Index of the first contact of the page. The default is 0. |
Connexions possibles
Votre client connecte son compte Brevo une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/brevo_list_contacts. Il devient la définition de tool de votre agent sans conversion.
Autres tools Brevo
- Obtenir un contactGETRenvoie un contact avec ses attributs, ses listes et les statistiques de campagnes des 90 derniers jours.
- Créer un contactPOSTCrée un contact. Envoyez email, ou l'attribut SMS, ou ext_id. Avec updateEnabled à true, un contact existant ayant le même identifiant est mis à jour au lieu d'échouer.
- Mettre à jour un contactPUTMet à jour un contact. Seuls les champs envoyés changent : listIds ajoute le contact à des listes et unlinkListIds l'en retire.
- Lister les listes de contactsGETListe les listes de contacts avec id, name, folderId et abonnés uniques. La réponse contient lists et count ; paginez avec limit et offset.
- Créer une liste de contactsPOSTCrée une liste de contacts vide dans un dossier et renvoie son id.
- Lister les campagnes emailGETListe les campagnes email, de la plus récente à la plus ancienne par défaut. La réponse contient campaigns et count ; paginez avec limit et offset. Les statistiques ne reviennent que si statistics est envoyé.
- Obtenir une campagne emailGETRenvoie une campagne email avec ses réglages, ses destinataires et les statistiques de son rapport.
- Créer une campagne emailPOSTCrée une campagne email en brouillon et renvoie son id. Envoyez le contenu dans exactement un champ parmi htmlContent, htmlUrl ou templateId. Définir scheduledAt planifie l'envoi, et recipients devient alors obligatoire.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
