Quickstart

Get your first transcript via the Capvo API in under two minutes.

1. Download Capvo

Capvo is a desktop app. It records your calls locally, transcribes them with Whisper, and pushes the result to the Capvo API so you can fetch it from anywhere.

Download for Windows (.exe installer, ~80 MB)
Download for Mac (.dmg disk image — coming soon)

Requires Windows 10+ or macOS 12+.

2. Create an account

Open the app and register with your email. You'll receive a verification code, then land on the home screen.

Your account is created against api.capvo.app. The same credentials you use in the desktop app are tied to the API keys you'll create below.

3. Record a call

Start a call on Google Meet, Zoom, Microsoft Teams, or your phone. Capvo detects the meeting automatically (no extension, no bot) and begins recording in the background.

To capture audio outside of those platforms (a podcast, an in-person meeting), click Start recording in the app and Capvo will use your microphone.

When the call ends, the transcript appears in your home tab. It's also pushed to the API and fired to any webhook you've registered.

4. Get your API key

In the desktop app: Settings → API Keys → Create a new key.

Copy the key immediately. It won't be shown again. Keys are prefixed with cpv_ and look like cpv_live_3kF8z2….

Tip: Create a separate key per environment (local, staging, production). If a key leaks you can revoke just that one without rotating everything.

5. Fetch your transcript

terminal

curl https://api.capvo.app/v1/notes \
  -H "Authorization: Bearer cpv_your_key"

You'll get back a paginated list of your meetings:

response.json

{
  "data": [
    {
      "id": "fd1c2b0e-08a2-4ee0-ab26-9f3a7a14b2c1",
      "title": "Q2 Revenue Review",
      "platform": "meet",
      "duration_seconds": 1842,
      "created_at": "2026-04-27T14:02:11Z",
      "ended_at": "2026-04-27T14:32:53Z",
      "transcript": [
        { "speaker": "Albert", "sequence": 1, "start_time": 4.2, "content": "Let's start with the numbers." },
        { "speaker": "Maya", "sequence": 2, "start_time": 9.1, "content": "Revenue is up 18% quarter over quarter." }
      ]
    }
  ],
  "next_cursor": "eyJpZCI6ImZkMWMyYjBlIn0",
  "has_more": true
}

Each note id is a UUID v4 and the transcript ships inline. To pull a single meeting by id:

curl https://api.capvo.app/v1/notes/fd1c2b0e-08a2-4ee0-ab26-9f3a7a14b2c1 \
  -H "Authorization: Bearer cpv_your_key"

6. Set up a webhook (optional)

Webhooks let you skip polling. Every time a call finishes transcribing, Capvo will POST the full payload to your endpoint.

In the app: Settings → Webhooks → Add endpoint. Enter your URL, select meeting.transcribed, and you're done. Every future call will be delivered automatically with an HMAC-SHA256 signature you can verify.

See the Webhooks reference for the full payload schema and verification examples in Node.js and Python.

What's next

Browse the API reference for every endpoint.
Wire up HMAC verification before deploying webhooks to production.
If you use Claude Desktop or another LLM agent, set up the MCP server to expose your transcripts as tools.