Convo API Docs

Understand the key data objects in the Convo API — conversations, transcripts, key points, feedback, and more.

The Convo API is organized around a few core data objects. Understanding these will help you build effective integrations.

Conversations

A conversation is the central object in Convo. It represents a single meeting and contains metadata like title, start/end time, duration, and segment count.

{
  "id": "sess_a1b2c3",
  "title": "Q1 Planning Review",
  "startTime": "2026-03-19T14:00:00.000Z",
  "endTime": "2026-03-19T14:45:00.000Z",
  "duration": 45,
  "segmentCount": 187
}

Conversations are the entry point for all other data — transcripts, key points, feedback, and emails are all accessed through a conversation ID.

→ List conversations | Update title | Delete

Transcripts

A transcript is the full text record of a conversation, broken into segments. Each segment contains the spoken text, speaker name, and timestamp.

{
  "segments": [
    { "text": "Let's review the Q1 numbers.", "speaker": "Alice", "timestamp": "2026-03-19T14:01:12.000Z" },
    { "text": "Revenue is up 15% from last quarter.", "speaker": "Bob", "timestamp": "2026-03-19T14:01:18.000Z" }
  ]
}

Transcripts are generated automatically after each meeting. The segmentCount on a conversation tells you how many segments are available.

→ Get transcript

Key Points

Key points are AI-generated structured summaries of a conversation. They include:

Sections — topic-grouped summary points with headings
Decisions — choices made during the meeting
Action items — tasks with owners, priority (high/medium/low), and confidence scores
Participants — people mentioned or present
Important dates — dates referenced with context

Use GET to retrieve cached key points (free, no AI credit). Use POST to generate or refresh them (consumes one AI generation credit).

→ Get key points | Generate key points

Communication Feedback

Feedback provides AI-powered coaching on your meeting performance. It includes:

Overall score — a numeric performance rating
Category scores — clarity, listening, time management, collaboration, decision making
Strengths — specific moments where you performed well, with quotes
Growth areas — suggestions for improvement with timestamps
Talk-to-listen ratio — how much you spoke vs. listened
Action plan — concrete steps to improve

Feedback requires at least 10 transcript segments to generate meaningful analysis.

→ Get feedback | Generate feedback

AI Generations

Several API endpoints use AI to generate content on demand. These AI generation endpoints consume monthly credits based on your subscription tier:

Tier	Monthly credits
Starter	10
Professional	100
Enterprise	Unlimited

AI generation endpoints: key points, feedback, email, and query. If a cached result exists, GET requests return it for free. POST requests with forceRefresh: true always consume a credit.

When your monthly limit is reached, AI generation endpoints return a 429 error with code ai_limit_exceeded.

→ Generate email | Query conversation

Calendar Events

If you've connected Google Calendar in the Convo dashboard, you can list upcoming events via the API. Calendar events include attendees, times, and time zones.

→ List calendar events

Webhooks

Webhooks deliver real-time event notifications to your server when things happen in Convo — like a new conversation being created, key points becoming ready, or a transcript completing.

Webhooks are available on Professional and Enterprise tiers. Payloads are signed with HMAC-SHA256 for verification. See the full Webhooks guide for events, payload format, and signature verification.

→ Manage webhooks

Core Concepts