Make an AI call to a contact

place an outbound AI phone call to a contact. Dials the contact's phone on file.

POST https://api.centerfy.ai/webhooks/inbound/contacts/:id/call

Headers

Header	Required	Value	Description
`x-api-key`	Yes	your sub-account API key (cfy_…)	Your API key. Alternatively, pass it as Authorization: Bearer `<key>`.
`Content-Type`	Yes	application/json	Request body is JSON.

Path parameters

Name	Type	Required	Description
`id`	`string (uuid)`	Yes	The contact id to call. The number dialed is this contact’s phone on file. 404 if not found; 400 if the contact has no phone.

Body parameters

Name	Type	Required	Default	Description
`agent_id`	`string`	Yes	—	UUID of the AI agent that should place the call. Must be a valid UUID (400 otherwise) and an agent you own (404 otherwise).
`pool_id`	`string`	No	—	Optional. UUID of a number pool to round-robin the caller-ID (from-number) across. Omit to use the agent’s default.

Request body

{
  "agent_id": "<agent_id>",
  "pool_id": "<pool_id>"
}

Example

curl -X POST "https://api.centerfy.ai/webhooks/inbound/contacts/{id}/call" \
  -H "x-api-key: $CENTERFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "agent_id": "<agent_id>",
  "pool_id": "<pool_id>"
}'

import { CenterfyClient } from "@centerfy/sdk";

const centerfy = new CenterfyClient({ apiKey: process.env.CENTERFY_API_KEY! });

const result = await centerfy.contacts.makeAiCall("<contactId>", {
  "agent_id": "<agent_id>",
  "pool_id": "<pool_id>"
});
console.log(result);

centerfy contacts make-ai-call <contactId> '{"agent_id":"<agent_id>","pool_id":"<pool_id>"}'

MCP tool: centerfy_contacts_make_ai_call (see MCP server)

Response

{
  "status": "success",
  "call_id": "call_7f3a2b1c9d8e",
  "message": "Call initiated"
}

Errors

400 — invalid contact id, invalid agent_id, or the contact has no phone on file.
401 — missing or invalid key.
404 — contact not found, or agent not found.

Notes

Places an outbound AI call to the contact’s phone on file. The success response fields shown are representative.