Skip to main content
POST
/
ai
/
phone-calls
/
action
/
call
Call Contact
curl --request POST \
  --url https://api.dev.uselevers.com/api-service/v1/ai/phone-calls/action/call \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contactUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "numberToCall": "<string>",
  "aiSettingsTemplateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

​
Authorization

All endpoints require Bearer token authentication.
HeaderTypeRequiredDescription
AuthorizationstringYesBearer authentication header of the form Bearer <token>

​
Getting Your API Key

See the Quickstart guide for instructions on obtaining your API credentials.

​
Use Cases

  • Automated Collections: AI can handle payment reminders and negotiate payment terms
  • Payment Follow-ups: Automatically follow up on outstanding invoices
  • Customer Communication: Handle routine customer inquiries without human intervention

​
Request Body

ParameterTypeRequiredDescription
contactUuidstring (UUID)YesThe unique identifier of the contact to call
numberToCallstringNoPhone number to call. If not provided, uses the contact’s default phone number
aiSettingsTemplateIdstring (UUID)NoAI settings template ID for customizing call behavior

​
Response

Returns a 201 status on successful initiation of the call.

​
AI Call Features

The AI calling system includes:
  • Natural Conversation: Advanced voice AI that understands context and responds naturally
  • Customizable Scripts: Use aiSettingsTemplateId to customize the conversation flow
  • Call Recording: All calls are recorded for quality assurance and compliance
  • Smart Routing: Intelligently routes to human agents when needed

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
contactUuid
string<uuid>
required

The unique identifier of the contact to call

​
numberToCall
string

Phone number to call. If not provided, uses the contact's default phone number

​
aiSettingsTemplateId
string<uuid>

AI settings template ID for customizing call behavior

Response

Successful Response