Skip to main content

​
Initiate a Call

POST https://api.agentvoice.com/api/agents/call
Initiates a phone call from an agent to a contact. Request Headers: 
Content-Type: application/json
x-api-key: your-api-key
x-organization-id: your-organization-id
Request Body: 
{
  "agentId": "uuid-of-the-agent",
  "phoneNumber": "+1XXXXXXXXXX",
  "notes": "Optional notes for context in this call"
}
Required Parameters:
  • agentId: The UUID of the agent that will make the call
  • phoneNumber: Phone number in the format +1XXXXXXXXXX
Optional Parameters:
  • notes: Additional context for the call
Example Response: 
{
  "message": "Call initiated successfully",
  "callId": "b7f2d8e1-6c3a-4d5b-9e8f-1a2b3c4d5e6f",
  "agentName": "Sales Assistant",
  "contactName": "John Doe",
  "phoneNumber": "+15551234567"
}
The contact must have a valid phone number in their profile. The call is initiated immediately upon successful request processing.