Calls
Start a call
Starts an automated phone call using one of your agents.
Authentication
AuthorizationBearerAuthenticate server-side requests with a Fonema API key. Create one in the API keys section of the Dashboard and send it in the Authorization header as Bearer <token>. Keep keys out of client-side code and public repositories.
Body
agentIdstringRequiredUnique identifier of the agent that will place the call.
How to get it: Find this value in your Fonema dashboard, under each agent name.
Example: "Ales-VLP5QKP1"
customerobjectInformation about the customer receiving the call.
customer.phoneNumberstringRequiredPhone number in E.164 format (including country code).
customer.namestringOptionalFull customer name.
customer.emailstringOptionalCustomer email address.
delayintegerOptionalDelay in seconds before starting the call.
variableValuesobjectOptionalCustom variables used during the call.
Format: Key-value pairs where each key matches a variable defined in your agent.
Important considerations
- Phone format: Always include country code (e.g., +52 for Mexico).
- Required variables: Make sure to include every variable your agent expects.