OverviewAPI ReferenceResources
Contacts

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.

GET
/api/v1/contacts/unresolved-threads

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: 25Minimum: 1Maximum: 100
curl -X GET "https://www.itsconvo.com/api/v1/contacts/unresolved-threads?limit=25" \
  -H "Authorization: Bearer <token>"

Open action items

{
  "data": [
    {
      "sessionId": "session_1773842400000",
      "actionItem": "Send the pilot pricing to Sarah",
      "hash": "9b2f6c0d4e8a1f3b5c7d9e0a2b4c6d8e",
      "meetingTitle": "Northwind pilot review",
      "createdAt": "2026-09-26T14:00:00Z",
      "stalenessDays": 9,
      "contactId": "contact_3f2b8c1e-7d4a-4c1b-9a6e-2b5d8f0c4e71",
      "contactName": "Sarah Lee",
      "contactCompany": "northwind.com"
    }
  ],
  "total": 1
}

Was this page helpful?

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

List calendar events

Returns upcoming events from the calendar connected in the Convo desktop app, Google or Outlook, by start time. Events come in the provider's own format. Declined and cancelled events are left out. Without `timeMax`, Outlook looks 7 days ahead and Google has no end.