Basic
Send Call (Simple)
Send an AI phone call with a custom objective and actions.
POST
Send Call (Simple)
Headers
Your API key for authentication.
Body
The phone number to call. Country code defaults to +1 (US) if not specified.
Formatting is flexible, however for the most predictable results use the E.164 format.
Formatting Examples
Formatting Examples
Expected/Ideal Format
- “+12223334444”
- “+91223334444”
- “+61223334444”
Valid, but not recommended:
- “2223334444”
- “+1 (222) 333-4444”
- “+1 222 333 4444”
- “222-333-4444”
Invalid
- “12223334444”
- “552223334444”
- “non-numeric characters”
- “2223334444 ext. 123”
Provide instructions, relevant information, and examples of the ideal conversation flow.
Best Practices
Best Practices
Out-of-the-Box Behaviors (Summarized):
- Speech pattern: Direct, concise, casual
- Spells out symbols, acronyms, abbreviations, percentages, etc. ($4,000,000 -> “four million dollars”)|
- Asks clarifying questions
- Ends call when objective is complete or voicemail is detected
Prompting Tips:
- Want to easily test out exactly how your agent will behave?
- Aim for less than >2,000 characters where possible.
- Simple, direct prompts are the most predictable and reliable.
- Frame instructions positively:
"Do this"
rather than"Don't do this"
- Ex. “Keep the conversation casual” rather than “Don’t be too formal”.
- This gives concrete examples of what to do, instead of leaving expected behavior open to interpretation.
Response
Can be success
or error
.
A unique identifier for the call (present only if status is success
).
Send Call (Simple)