Overview

The Circleback API lets you read your meetings, notes, action items, transcripts, people, and companies. Use it to sync meeting data into your own tools, build automations, or search across your conversations.

Authentication

Send your API key as a bearer token in the Authorization header of every request:

curl https://circleback.ai/api/meetings \
  -H "Authorization: Bearer cb_<secret>"

Get an API key

To get started, go to Settings → API keys in Circleback and create an API key. Keys look like cb_<secret> and are shown once at creation, so store yours somewhere safe.

Base URL

https://circleback.ai/api

The API accepts and returns JSON.

Pagination

List endpoints return one page of results at a time. Omit cursor from the first request. When another page is available, the response includes an RFC 8288 Link header with rel="next":

Link: </api/meetings?cursor=eyJwYWdlIjoxfQ>; rel="next"

Follow that URL to request the next page. Cursors are opaque and should not be modified or reused with different filters.

Rate limits

Requests are counted per Circleback account, across all API keys and MCP or CLI OAuth tokens for the account. Limits are based on the plan the account is on.

Every response reports whichever of the two windows you are closest to exhausting. RateLimit-Limit is that window's allowance, so you can tell the windows apart: 20 in the example below is the Free per-minute limit, not the per-second one. RateLimit-Reset is the seconds until that same window refills:

RateLimit-Limit: 20
RateLimit-Remaining: 14
RateLimit-Reset: 24

Requests over the limit are rejected with 429 Too Many Requests and a Retry-After header holding the number of seconds to wait before trying again. The JSON body is the same error envelope as other API failures, and its message names the plan whose limit you hit:

{
  "error": "Ratelimit exceeded for the Free plan.",
  "code": "RATE_LIMITED"
}

Explore the reference

Endpoints are grouped by resource in the sidebar: Meetings, Action items, Calendar, Companies, People, and Tags. Every page documents the request and response shapes and lets you try the endpoint with your API key.