Make AI Call

Trigger an outbound AI voice call to a contact using a specified agent.

POST

Make AI Call

Initiate an outbound AI voice call using a specified agent. The agent calls the contact’s phone number and runs the conversation using its configured prompt, tools, and voice settings.

Endpoint

POST https://crmwebhook.com/functions/v1/crm-api/make-ai-call/{agent_id}

Path Parameters

Parameter	Type	Required	Description
`agent_id`	`string` (UUID)	Yes	The agent to use for the call

Headers

Header	Value	Required
`x-api-key`	`cfy_your_api_key`	Yes
`Content-Type`	`application/json`	Yes

Request Body

{
  "contact_id": "c1a2b3d4-e5f6-7890-abcd-ef1234567890",
  "organization_id": "88e7bb59-42b2-4f8f-b818-83dfc129dd1b",
  "sub_account_id": "d457c95d-de9e-42f3-9e21-530c5cd4caa1"
}

Body Parameters

Field	Type	Required	Description
`contact_id`	`string` (UUID)	Required	Contact to call
`organization_id`	`string` (UUID)	Required	Must match the API key’s organization
`sub_account_id`	`string` (UUID)	Required	Must match the API key’s sub-account

Example Request

curl -X POST \
  https://crmwebhook.com/functions/v1/crm-api/make-ai-call/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "x-api-key: cfy_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "c1a2b3d4-e5f6-7890-abcd-ef1234567890",
    "organization_id": "88e7bb59-42b2-4f8f-b818-83dfc129dd1b",
    "sub_account_id": "d457c95d-de9e-42f3-9e21-530c5cd4caa1"
  }'

Response Shape

{
  "status": "call_initiated",
  "call_type": "outbound",
  "agent_name": "Sales Assistant"
}

Response Codes

Status	Meaning
`200`	Call initiated successfully
`400`	Missing required fields
`401`	Invalid API key
`403`	Organization/sub-account mismatch with API key scope
`500`	Internal configuration error
`502`	Upstream AI service failed