Tools

Manage Custom Action

Create, retrieve, update, delete, attach, or detach custom actions for agents. Custom actions extend agent capabilities by integrating external APIs — pull live information, create records, or adjust conversational flow. Use the **operation** field to choose what to do. For "attach" and "detach", provide an agent ID and a list of action IDs.

Get Call

Retrieve detailed information about a specific call. Returns transcript, recording URL, call status, duration, end-call reason, collected variables, and telephony details.

Manage Contact

Create, retrieve, update, or delete a contact in Synthflow. Contacts are used for phonebook management and call targeting. Use the **operation** field to choose the action.

Export Analytics

Export usage analytics data from Synthflow. Supports datetime-based filtering for precise time-based queries. Returns call metrics and usage summaries.

Update Agent

Update an existing AI voice agent's configuration. Only provided fields are updated; omitted fields remain unchanged. Can modify name, phone number, voice, prompt, webhook URL, recording settings, and more.

List Calls

List call history for a specific agent. Supports filtering by date range, call status, duration, and lead phone number. Returns call metadata with pagination.

Manage Knowledge Base

Create, retrieve, update, or delete a knowledge base. Knowledge bases allow agents to reference specific domain information during calls. Use the **operation** field to choose the action.

List Agents

List AI voice agents in your Synthflow account. Returns agent details including name, type, phone number, and configuration. Supports pagination for large collections.

Manage Subaccount

Create, retrieve, update, delete, or list subaccounts for agency-level operations. Subaccounts share the main account's total concurrency, as set by your plan.

List Phone Numbers

List provisioned phone numbers in your workspace. Returns number details including SID and capabilities. Use these numbers when assigning agents for inbound/outbound calling.

Delete Agent

Permanently delete an AI voice agent from your Synthflow account. This action cannot be undone.

Make Call

Initiate an outbound phone call through a Synthflow AI agent. Specify the agent, recipient phone number, and recipient name. Supports custom variables for dynamic prompt injection, custom greetings, and webhook URLs for post-call notifications.

Get Agent

Retrieve detailed information about a specific AI voice agent by its model ID. Returns the full agent configuration including prompts, voice settings, phone number, type, and recording preferences.

Run Simulation

List simulation suites or execute a simulation suite to test an agent before going live. Simulations run rehearsal calls using predefined test cases.

List Voices

Browse available voices for AI agents. Returns voice IDs, names, and preview URLs. Use the voice ID when creating or updating an agent.

Create Agent

Create a new AI voice agent in Synthflow. Configure the agent type (inbound, outbound, or widget), voice, prompt, language, and other settings. Returns the new agent's model ID.