Lister les conversations avec un contact
Chaque fil que l'adresse a écrit ou qui lui a été écrit, dans tous les dossiers : l'onglet Courrier d'un contact dans l'application. L'adresse n'a pas besoin d'être un contact enregistré. `limit` va jusqu'à 100 et vaut 25 par défaut, et `nextCursor` revient comme `cursor` tant que `hasMore` est vrai.
Exécute le véritable appel sur votre espace de travail, avec votre propre clé.
GET /contacts/{email}/threads
Chaque fil que l'adresse a écrit ou qui lui a été écrit, dans tous les dossiers : l'onglet Courrier d'un contact dans l'application. L'adresse n'a pas besoin d'être un contact enregistré. limit va jusqu'à 100 et vaut 25 par défaut, et nextCursor revient comme cursor tant que hasMore est vrai.
Exemple
Nécessite threads:read, car il lit le courrier et non le contact.
curl "$OE/contacts/ada%40example.com/threads?q=invoice&sort=newest" -H "$AUTH"{ "object": "list", "data": [ { "object": "thread", "id": "thr_5d31c2a8…", "subject": "Invoice 2026-09", "from": { "name": "Ada Lovelace", "email": "[email protected]" }, "receivedAt": "2026-09-22T16:04:11.000Z", "messageCount": 3, "hasUnread": true, "labels": [{ "id": "INBOX", "name": "Inbox" }] } ], "hasMore": false, "nextCursor": null}q cherche dans ces fils avec la syntaxe de recherche de la boîte. sort vaut newest (par défaut), oldest, sender ou subject. Renvoyez cursor avec les mêmes q et sort.
Chaque ligne est un résumé. GET /threads/{id} lit les messages derrière.