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. Optionally prepare the recording as a downloadable file.

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, list, retrieve, update, delete, attach, or detach knowledge bases. Add domain content with manage_knowledge_base_source, then attach the knowledge base to an agent for use during calls.

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 inbound availability. Use these numbers when assigning agents for inbound/outbound calling. Discover workspace_id with manage_contact (get/list) or run_simulation (list).

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 and custom greetings. Configure post-call notifications on the agent with update_agent.

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, execute a suite to test an agent before going live, or retrieve a simulation session's results. 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. Discover workspace_id with manage_contact (get/list) or run_simulation (list).

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.

Manage Knowledge Base Source

List, add, update, or delete content sources in a knowledge base. Add plain text, a website URL, or a hosted PDF so agents can answer questions about your content.