Centerfy API overview
Everything in Centerfy is available over a REST API: contacts, pipelines, AI agents, calls, messages, calendars, invoices, agency sub-accounts and more. One API key, JSON in and out.
The Centerfy API lets you build on top of your sub-account (or, with an agency key, on top of every sub-account you own). It is the same API the Centerfy SDK, CLI and MCP server use, so anything you can do in those tools you can do with a plain HTTP request.
API key types, how to send them, and what the plan gate means.
The JSON envelope, IDs, unknown fields and the few non-JSON endpoints.
Typed TypeScript client, a command-line tool and an MCP server for AI agents.
45 events Centerfy can POST to your URL when something changes.
Base URLs
| API | Base URL | Key |
|---|---|---|
| Sub-account API | https://api.centerfy.ai/webhooks/inbound/… | Sub-account key |
| Agency API | https://api.centerfy.ai/webhooks/inbound/agency/… | Agency key |
| Legacy API | https://crmwebhook.com/functions/v1/crm-api | Either (see each page) |
The path prefix /webhooks/inbound is historical: these endpoints started life as “inbound webhooks” for CRM integrations and the prefix was kept so existing integrations keep working.
What’s in the sub-account API
Contacts, tags, notes, companies, pipelines & opportunities, smart lists, custom fields, lead scoring.
Agents, voices, custom tools, knowledge bases, phone numbers & pools, AI calls, call history and recordings.
SMS, email, WhatsApp, Facebook and Instagram messages, conversations, campaigns.
Calendars & free slots, appointments, scheduled calls/messages, reminders, workflows, forms.
Contracts, invoices, quotes, reviews and review requests.
Wallet & usage, analytics, team users, outbound webhook subscriptions, phone number purchasing.
Agency API
With an agency API key you manage the sub-accounts your agency owns: create, archive, pause, read usage, manage their users and API keys, and read the agency wallet. See Sub-accounts.
A first request
curl "https://api.centerfy.ai/webhooks/inbound/contacts?limit=5" \
-H "x-api-key: $CENTERFY_API_KEY"{
"status": "success",
"total": 1284,
"limit": 5,
"offset": 0,
"has_more": true,
"contacts": [ { "id": "…", "name": "Jane Doe", "email": "[email protected]", "…": "…" } ]
}Machine-readable spec
An OpenAPI 3.1 document covering every sub-account and agency endpoint is published at /api/openapi.json. Import it into Postman, Insomnia or a code generator.