OverviewAPI ReferenceResources
Contacts

List contacts

The people Convo Memory has met in your calendar meetings, most meetings first, then most recently seen. Requires a Professional or Enterprise plan with Convo Memory enabled. Without Memory, the list is empty and reason is no-brain.

GET
/api/v1/contacts

Authorization

AuthorizationRequiredBearer <token>

A Convo API key: convo_ followed by 32 hex characters. Create it in the Convo desktop app under Settings → Convo API.

In: header

Query Parameters

limitinteger

Max results to return

Default: 50Minimum: 1Maximum: 200
offsetinteger

Number of results to skip

Default: 0
searchstring

Matches email or display name, case-insensitive

curl -X GET "https://www.itsconvo.com/api/v1/contacts?limit=50&offset=0&search=%3Cstring%3E" \
  -H "Authorization: Bearer <token>"

List of contacts

{
  "data": [
    {
      "id": "contact_3f2b8c1e-7d4a-4c1b-9a6e-2b5d8f0c4e71",
      "email": "sarah@northwind.com",
      "displayName": "Sarah Lee",
      "companyDomain": "northwind.com",
      "meetingCount": 4,
      "firstSeenAt": "2026-08-12T15:00:00Z",
      "lastSeenAt": "2026-09-29T14:00:00Z"
    }
  ],
  "pagination": {
    "total": 37,
    "limit": 50,
    "offset": 0
  }
}

Was this page helpful?

Get a contact briefing

Everything Convo Memory has on one contact before your next call: the relationship summary, recent meetings, open action items and recent decisions. Requires a Professional or Enterprise plan with Convo Memory enabled. Without Memory, it returns 403. A contact from another account returns 404.

List unresolved threads

Open action items from meetings with your contacts, oldest meeting first, so the ones waiting longest come first. Items you marked resolved or dismissed are left out, and so are meetings not matched to a contact. Requires a Professional or Enterprise plan with Convo Memory enabled. Without Memory, the list is empty and `reason` is `no-brain`.