Synthflow integration
Synthflow builds AI voice and chat agents for phone calls. Create and update agents, place outbound calls and batch call campaigns, read call transcripts, recordings and analytics, run chat sessions and outbound WhatsApp or SMS chats, manage actions (bookings, transfers, custom HTTP calls), knowledge bases, memory stores, contacts, phone numbers, phone books, voices, subaccounts and simulation test suites, and read webhook logs. The WebSocket media-call routes, the streamed test-case generator and the workspace MCP-server configuration routes (documented in the vendor spec but not served by its API hosts) are not exposed, and API keys of subaccounts and webhook headers are never returned. Authentication is a workspace API key sent as a Bearer token, plus the API host of the workspace cluster (US, EU or the legacy Global cluster).
Say what should happen.
The workflow builds itself.
What you can do with Synthflow
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Action, 5 operations
create_actionCreate actionPOSTCreates one action: send exactly one key named after its type (REAL_TIME_BOOKING, LIVE_TRANSFER, CUSTOM_ACTION...) holding its settings. Returns action_id; attach it to an agent with attach_action.delete_actionDelete actionDELETEDeletes an action by id.get_actionGet actionGETRetrieves metadata about an action.list_actionsList actionsGETLists the actions of the workspace (bookings, transfers, SMS, email, custom HTTP actions, extractors, evaluations). Paged with limit and offset.update_actionUpdate actionPUTUpdates an action: send the key of its type with the settings to change. For live transfer, custom, information extractor and post-call email actions, omitted fields keep their values.
Assistant, 5 operations
create_agentCreate agentPOSTCreates an agent: type (outbound, inbound, widget or chat), name and the agent settings object (prompt, LLM, voice, language). Returns its model_id.delete_agentDelete agentDELETEUse this endpoint to delete an agent.get_agentGet agentGETReturns one agent (by model_id) with its settings; include_actions=true adds its attached actions.list_agentsList agentsGETLists all agents you have in your account.update_agentUpdate agentPUTUse this endpoint to update an agent's name, phone number, or other parameters. Only the provided parameters will be updated, and others won't be removed or changed.
Contact, 5 operations
create_contactCreate contactPOSTCreates a contact (name and phone_number, optional email and contact_metadata).delete_contactDelete contactDELETEDeletes a contact by id.get_contactGet contactGETReturns one contact by id.list_contactsList contactsGETLists the contacts of the workspace, optionally filtered by search.update_contactUpdate contactPATCHUpdates a contact: send only the fields to change.
Knowledge base, 5 operations
create_knowledge_baseCreate knowledge basePOSTCreates a new knowledge base and returns its ID.delete_knowledge_baseDelete knowledge baseDELETEDeletes a knowledge base by id.get_knowledge_baseGet knowledge baseGETRetrieves the knowledge base's name and use condition.list_knowledge_basesList knowledge basesGETRetrieves knowledge bases for the workspace.update_knowledge_baseUpdate knowledge basePUTUpdates a knowledge base name or rag_use_condition (when the agent should search it).
Memory store, 5 operations
create_memory_storeCreate memory storePOSTCreates a memory store (title, description) that agents can use to remember past calls with a contact.delete_memory_storeDelete memory storeDELETEDeletes a memory store by id.get_memory_storeGet memory storeGETReturns one memory store by id.list_memory_storesList memory storesGETLists the memory stores (memories of past calls shared by agents), optionally filtered by search.update_memory_storeUpdate memory storePATCHUpdates a memory store title or description.
Simulation case, 5 operations
create_simulation_caseCreate simulation casePOSTCreate a new simulation case for a workspace.delete_simulation_caseDelete simulation caseDELETEDelete a simulation case by ID.get_simulation_caseGet simulation caseGETRetrieve a simulation case by ID.list_simulation_casesList simulation casesGETList simulation cases with pagination and optional filtering.update_simulation_caseUpdate simulation casePUTUpdate an existing simulation case.
Simulation scenario, 5 operations
create_simulation_scenarioCreate simulation scenarioPOSTCreate a new simulation scenario. Scenarios are templates used when generating test cases to ensure coverage of specific situations.delete_simulation_scenarioDelete simulation scenarioDELETEDelete a simulation scenario by ID.get_simulation_scenarioGet simulation scenarioGETRetrieve a simulation scenario by ID.list_simulation_scenariosList simulation scenariosGETList simulation scenarios with pagination and optional filtering.update_simulation_scenarioUpdate simulation scenarioPUTUpdate an existing simulation scenario.
Simulation suite, 5 operations
create_simulation_suiteCreate simulation suitePOSTCreate a new simulation suite attached to a specific agent. The suite can only be executed on the agent specified by model_id.delete_simulation_suiteDelete simulation suiteDELETEDelete a simulation suite by ID.get_simulation_suiteGet simulation suiteGETRetrieve a simulation suite by ID.list_simulation_suitesList simulation suitesGETList simulation suites with pagination and optional filtering.update_simulation_suiteUpdate simulation suitePUTUpdate an existing simulation suite.
Source, 5 operations
add_knowledge_base_sourceAdd knowledge base sourcePOSTAdds a source to a knowledge base: a web page (link url), a file url, or raw text (content). It is processed asynchronously.delete_knowledge_base_sourceDelete knowledge base sourceDELETEDeletes a source from a knowledge base.get_knowledge_base_sourceGet knowledge base sourceGETReturns one source of a knowledge base. For a `text` source, `content` holds the full text and `url` is a download link for the same text that expires after 7 days.list_knowledge_base_sourcesList knowledge base sourcesGETReturns a paginated list of sources for the specified knowledge base.update_knowledge_base_sourceUpdate knowledge base sourcePUTUpdate an existing knowledge base source by source ID.
Subaccount, 5 operations
create_subaccountCreate subaccountPOSTCreates a subaccount (agency client workspace) with optional limits, permissions, Twilio credentials and a user invitation (user_email returns a sign_in_link).delete_subaccountDelete subaccountDELETEDeletes a subaccount by ID.get_subaccountGet subaccountGETRetrieves detailed metadata about a specific subaccount by ID.list_subaccountsList subaccountsGETLists the subaccounts of the agency with their limits and permissions.update_subaccountUpdate subaccountPUTUpdates a subaccount: name, limits, permissions, Twilio credentials or a new invited user. Leave a field out to keep it.
Attach, 4 operations
attach_actionAttach actionPOSTAttaches actions (action ids from list_actions) to an agent (model_id). Sending the same action and attachment_type again updates that attachment.attach_contact_to_memory_storeAttach contact to memory storePOSTAttaches a contact to a memory store.attach_knowledge_baseAttach knowledge basePOSTAttaches a knowledge base to an agent (model_id) so it can search it during calls.attach_memory_store_to_agentAttach memory store to agentPOSTAttaches a memory store to an agent so its calls read and write memories.
Chat, 4 operations
create_chatCreate chatPOSTStarts a chat session with a chat agent (model_id) under an id you choose (chat_id), then send messages with send_chat_message.delete_chatDelete chatDELETEDelete a chat session.get_chatGet chatGETReturns one chat session with its messages.list_chatsList chatsGETRetrieve a list of chats, optionally filtered by agent ID.
Detach, 4 operations
detach_actionDetach actionPOSTDetaches actions (action ids) from an agent (model_id). The actions themselves are kept.detach_contact_from_memory_storeDetach contact from memory storePOSTDetaches a contact from a memory store.detach_knowledge_baseDetach knowledge basePOSTDetaches a knowledge base from an agent (model_id).detach_memory_store_from_agentDetach memory store from agentPOSTDetaches a memory store from an agent.
Entry, 4 operations
create_phone_book_entryCreate phone book entryPOSTAdds an entry to a phone book: a phone_number and the transfer_condition saying when the agent transfers to it.delete_phone_book_entryDelete phone book entryDELETEDeletes an entry from a phone book.list_phone_book_entriesList phone book entriesGETList the entries of a phone book.update_phone_book_entryUpdate phone book entryPUTReplace the phone number and transfer condition of a phone book entry. Both fields are required. A phone number must be unique within its phone book.
Number, 4 operations
delete_phone_numberDelete phone numberDELETEDeletes a phone number from the workspace and detaches it from its agents. For a number bought through Synthflow this also cancels its monthly subscription.get_phone_numberGet phone numberGETRetrieves detailed information about a specific phone number.list_phone_numbersList phone numbersGETLists the phone numbers of a workspace (workspace id required), optionally only those free for inbound agents (is_available). Paged with limit and offset.update_phone_numberUpdate phone numberPATCHUpdates the configuration of a phone number.
Batch, 3 operations
create_batch_callCreate batch callPOSTCreates a batch of outbound calls that are dialed over time as your account's concurrency allows.get_batch_callGet batch callGETReturns the batch's status and its recipient counters.list_batch_callsList batch callsGETLists the workspace's batch calls, most recently created first.
Call, 3 operations
get_callGet callGETReturns one call by call_id: transcript, status, duration, collected variables, executed actions and timestamps. Use get_call_recording for the audio.list_callsList callsGETReturns a paginated list of calls for the specified model. You can optionally filter by time window, status, duration range, or phone number.make_callMake callPOSTPlaces a real outbound phone call now from an agent (model_id) to phone (billed per minute). Returns call_id: read the outcome with get_call.
Phonebook, 3 operations
create_phone_bookCreate phone bookPOSTCreates a phone book (a list of transfer destinations used by a live transfer action).delete_phone_bookDelete phone bookDELETEDeletes a phone book by id.list_phone_booksList phone booksGETList all phone books in your workspace.
Simulation, 3 operations
get_simulationGet simulationGETRetrieve a simulation by ID.list_simulationsList simulationsGETList simulations with pagination and optional filters.start_simulationStart simulationPOSTStart a new simulation using a simulation case.
Log, 2 operations
get_webhook_logGet webhook logGETReturns one webhook delivery: url, payloads sent and received, status code, timestamps and attempt number.list_webhook_logsList webhook logsGETLists the webhook deliveries of a workspace (paged with page_number and page_size), filterable by type, status, method, date, agent or call.
Phone number, 2 operations
attach_phone_numbers_to_agentAttach phone numbers to agentPUTAdd one or more phone numbers to an agent's number pool, identified by phone number or by slug.detach_phone_number_from_agentDetach phone number from agentDELETERemove one phone number from an agent's number pool. The number stops routing inbound calls to the agent and can no longer be used as its outbound caller ID.
Analytics, 1 operation
export_analyticsExport analyticsGETExports call analytics for BI reporting, filtered by from_date, to_date (at most 120 days), model_id and type_of_call.
By agent, 1 operation
list_simulation_cases_by_agentList simulation cases by agentGETList all simulation cases created for a specific agent.
Cancel, 1 operation
cancel_batch_callCancel batch callPOSTPermanently stops the batch. Recipients that have not been dialed are marked canceled and will never be called. Calls already in progress are not hung up.
Custom number, 1 operation
import_phone_numberImport phone numberPOSTImports a custom phone number into your workspace. This is useful for direct SIP dialing scenarios where your telephony provider does not offer elastic SIP trunking.
Execute, 1 operation
execute_simulation_suiteExecute simulation suitePOSTExecute all test cases in a suite. The suite runs on the agent it was created for (determined by the suite's model_id).
Initialize, 1 operation
initialize_actionInitialize actionPOSTInitializes a custom action (action_id) with values for its variables.
Memory data, 1 operation
get_contact_memory_dataGet contact memory dataGETReturns what a memory store remembers about one contact.
Message, 1 operation
send_chat_messageSend chat messagePOSTSends a user message to the agent in an existing chat session and returns the agent's reply.
Outbound, 1 operation
start_outbound_chatStart outbound chatPOSTStarts an outbound WhatsApp or SMS conversation from a chat agent to to_number (real message, billed). WhatsApp outside the 24-hour window needs an approved template.
Pause, 1 operation
pause_batch_callPause batch callPOSTSuspends dialing. Recipients that have not been dialed stay queued, so resuming continues where the batch left off. Calls already in progress are not affected.
Recording, 1 operation
get_call_recordingGet call recordingGETReturns a signed download link (location) to the audio recording of a call (call_id), valid 24 hours. Fails with 404 when the call has no recording or is not in this workspace.
Resume, 1 operation
resume_batch_callResume batch callPOSTResumes a paused batch.
Session, 1 operation
list_simulation_sessionsList simulation sessionsGETList simulation sessions with pagination and optional filters.
Task, 1 operation
list_batch_call_recipientsList batch call recipientsGETLists every recipient in the batch with its outcome, in the order they were added.
Version, 1 operation
list_agent_versionsList agent versionsGETLists the published versions of an agent, newest first.
Voice, 1 operation
list_voicesList voicesGETLists the voices available to a workspace (workspace id required), filterable by provider and name. Paged with limit and offset.
Use Synthflow from Claude Code, Cursor or Codex
Connect Synthflow in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Synthflow operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Synthflow
- Create your workspace
Sign up free. Nothing to install.
- Connect Synthflow once
Add your Synthflow connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Synthflow integration FAQ
What can you do with the Synthflow integration?
LiveContext exposes 102 operations on Synthflow, covering action, assistant, contact and knowledge base.
