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