OverviewAPI ReferenceResources
Contacts

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.

GET
/api/v1/contacts/{id}/briefing

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

Path Parameters

idRequiredstring

Contact ID from List contacts

Query Parameters

historyLimitinteger

How many recent meetings to read for the briefing

Default: 25Minimum: 1Maximum: 50
curl -X GET "https://www.itsconvo.com/api/v1/contacts/contact_3f2b8c1e-7d4a-4c1b-9a6e-2b5d8f0c4e71/briefing?historyLimit=25" \
  -H "Authorization: Bearer <token>"

The briefing

{
  "data": {
    "contact": {
      "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"
    },
    "summary": {
      "prose": "Sarah leads operations at Northwind and is evaluating a three-month pilot.",
      "topics": [],
      "open_questions": [
        "Who signs off on the pilot budget?"
      ]
    },
    "summaryGeneratedAt": "2026-09-29T15:10:00Z",
    "recentMeetings": [
      {
        "sessionId": "session_1773842400000",
        "title": "Northwind pilot review",
        "date": "2026-09-26T14:00:00Z"
      }
    ],
    "openActionItems": [
      {
        "item": "Send the pilot pricing to Sarah",
        "sessionId": "session_1773842400000",
        "hash": "9b2f6c0d4e8a1f3b5c7d9e0a2b4c6d8e",
        "owner": "Alex Kim",
        "priority": "high",
        "meetingDate": "2026-09-26T14:00:00Z",
        "meetingTitle": "Northwind pilot review"
      }
    ],
    "recentDecisions": [
      "Start the pilot with the support team"
    ]
  }
}

Was this page helpful?

Query conversation

Answers a question about one call from its transcript. Each request uses one AI credit. A call that doesn't exist returns 404 without using one. `suggestedQueries` are fixed follow-up questions picked from words in your question.

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