Skip to main content

Calls

Start a call

Starts an automated phone call using one of your agents.

Authentication​

AuthorizationBearer

Authenticate 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​

agentIdstringRequired

Unique 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"

customerobject

Information about the customer receiving the call.

customer.phoneNumberstringRequired

Phone number in E.164 format (including country code).

customer.namestringOptional

Full customer name.

customer.emailstringOptional

Customer email address.

delayintegerOptional

Delay in seconds before starting the call.

variableValuesobjectOptional

Custom 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.