Synthflow AI provides AI-powered voice agents to automate both inbound and outbound calls, enhancing customer engagement and operational efficiency.
Synthflow AI provides AI-powered voice agents to automate both inbound and outbound calls, enhancing customer engagement and operational efficiency. On Nagent, Synthflow AI is exposed as a fully-configurable ai agents integration that any agent can call — 79 actions, and API key authentication. No code is required to wire Synthflow AI into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Synthflow AI to automate the kinds of tasks ai agents teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Synthflow AI into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Synthflow AI, with input parameters and output schema. Drop these into any step of an agent built in Helix.
SYNTHFLOW_AI_ADD_KB_SOURCE_DOCUMENTTool to add a document to a knowledge base source. Use when you need to attach PDF files, web pages, or text content to an existing knowledge base.
Input parameters
Required for 'pdf' or 'web' types. Hosted PDF URL or website URL to scrape
Source identifier or display name for the document
Type of document source: 'pdf' for hosted PDF files, 'text' for plain text content, or 'web' for website URLs
Required for 'text' type. Contains the full text content of the document
Unique identifier of the knowledge base to add the document to
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_ATTACH_ACTIONS_TO_AGENTTool to attach one or more actions to an agent. Use when you need to configure an agent with specific actions by providing the agent's model_id and an array of action IDs.
Input parameters
Array of action IDs to attach. To find an action's ID, go to its page in your Synthflow dashboard
The ID of the agent you want to attach an action to
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_ATTACH_CONTACT_TO_MEMORY_STORETool to attach a contact to a memory store. Use when you need to associate a specific contact with a memory store for persistent data storage.
Input parameters
The unique identifier of the contact to attach to the memory store
The unique identifier of the memory store to attach the contact to
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_ATTACH_KNOWLEDGE_BASE_TO_AGENTTool to attach a knowledge base to an agent. Use when you need to connect a knowledge base to a specific AI assistant by providing both IDs.
Input parameters
ID of the agent to which knowledge base needs to be attached
The identifier for the knowledge base being attached
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_ATTACH_MEMORY_STORE_TO_AGENTTool to attach a memory store to an agent. Use when you need to connect a memory store resource to a specific assistant for knowledge retrieval.
Input parameters
The agent's model ID to attach the memory store to
The memory store ID to attach
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_CREATE_ACTIONTool to create a new action in Synthflow AI. Use when you need to configure an action such as real-time booking, information extraction, live transfer, SMS sending, custom HTTP calls, or custom evaluations. Exactly one action type must be specified in the request.
Input parameters
Send SMS action configuration.
Custom evaluation action configuration.
Custom action configuration for HTTP API calls.
Live transfer action configuration.
Real-time booking action configuration.
Information extractor action configuration. Can be YES_NO, SINGLE_CHOICE, or OPEN_QUESTION type.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_CREATE_ASSISTANTTool to create a new assistant. Use when you need to initialize a Synthflow AI assistant by specifying its name, type, and agent configuration.
Input parameters
Name of the assistant.
Type of assistant to create. Note: 'outbound' type typically requires phone_number and caller_id_number.
Assistant configuration object. At least one sub-parameter must be provided. Examples include 'voice_id'. Additional supported fields may be included per API docs.
Assistant description.
Whether to record the conversation.
Maximum call duration settings.
Phone number attached to the agent. Required for type='outbound' and typically required for type='inbound'.
Caller ID number to display when making outbound calls. Required for type='outbound'.
HTTPS URL to receive post-call data (e.g., transcript).
HTTPS URL to receive inbound call webhooks.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_CREATE_CONTACTTool to create a new contact in Synthflow AI. Use when you need to add a contact with name and phone number.
Input parameters
The contact's full name
The contact's email address
The contact's phone number in E.164 format (e.g., +15551234567)
Additional metadata for the contact as key-value pairs
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_CREATE_KNOWLEDGE_BASETool to create a new knowledge base and return its ID. Use when you need to set up a knowledge repository for retrieval-augmented generation (RAG) in assistants.
Input parameters
Designation for the knowledge base
Specifies when this knowledge base should be activated during conversations
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_CREATE_MEMORY_STORETool to create a new memory store. Use when you need to initialize a knowledge repository for storing conversation history, customer data, or other contextual information.
Input parameters
The name for the memory store
A brief explanation of the memory store's purpose
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_CREATE_PHONE_BOOKTool to create a new phone book. Use when you need to create a contact list for organizing phone numbers in Synthflow AI.
Input parameters
Phone book name
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_CREATE_PHONE_BOOK_ENTRYTool to create a phone book entry. Use when you need to add a new phone number with a transfer condition to an existing phone book.
Input parameters
Phone number to add to the phone book in E.164 format (e.g., +12025551234).
Unique identifier of the phone book where the entry will be created.
Condition that triggers the transfer to this phone number (e.g., 'When the caller asks for a sales representative').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_CREATE_SIMULATION_CASETool to create a new simulation case. Use when you need to set up test scenarios for evaluating assistant behavior against defined success criteria.
Input parameters
Name of the simulation case for identification
Type of simulation case - 'custom' for manual scenarios or 'agent_based' to derive from an existing agent
Instructions or scenario that will be used during the simulation
Optional agent ID to base the generated simulation case upon. Required when type is 'agent_based'
List of evaluation conditions that define successful simulation execution
Determines if 'all' success criteria must pass or 'any' single criterion is sufficient
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_CREATE_SIMULATION_SCENARIOTool to create a new simulation scenario. Use when you need to define a template for generating test cases to ensure coverage of specific situations.
Input parameters
Label for the simulation scenario template.
Description of what the scenario template should verify when generating test cases.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_CREATE_SIMULATION_SUITETool to create a new simulation suite attached to a specific agent. Use when you need to set up test scenarios for an agent. The suite can only execute on the agent specified by model_id.
Input parameters
Identifier for the simulation suite
Locale code (default: en-US); examples include 'es-ES', 'fr-FR'
Agent model ID this suite is for. The suite can only run on this specific agent.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_CREATE_TEAMTool to create a new team. Use when you need to programmatically set up a Synthflow AI assistant group with routing rules.
Input parameters
Unique name for the new team assistant
Phone number in E.164 format for voice integration; required only if voice integration is enabled
Model ID of the lead assistant for this team
HTTPS endpoint to receive post-call data
List of sub-assistants with routing rules to attach to the team
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DELETE_ACTIONTool to delete an existing action. Use after confirming the action ID to permanently remove it.
Input parameters
Unique identifier of the action to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DELETE_ASSISTANTTool to delete an existing AI assistant. Use after confirming the assistant ID. Example: Delete assistant with ID 'assistant_123'.
Input parameters
Unique identifier of the assistant to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DELETE_CHATTool to delete a chat session. Use when you need to remove an existing chat by its ID. Confirm the chat ID before calling.
Input parameters
Unique identifier of the chat session to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DELETE_CONTACTTool to delete an existing contact. Use after confirming the contact ID.
Input parameters
Unique identifier of the contact to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DELETE_KNOWLEDGE_BASETool to delete an existing knowledge base. Use after confirming the knowledge base ID to permanently remove it.
Input parameters
Unique identifier of the knowledge base to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DELETE_KNOWLEDGE_BASE_SOURCETool to delete a source from a knowledge base. Use when you need to remove a specific source from a knowledge base after confirming both IDs.
Input parameters
Unique identifier of the source to be deleted from the knowledge base
Unique identifier of the knowledge base containing the source
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DELETE_MEMORY_STORETool to delete a memory store. Use when you need to remove a memory store after confirming its ID.
Input parameters
The unique identifier of the memory store to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DELETE_PHONE_BOOKTool to delete an existing phone book. Use when you need to remove a Synthflow AI phone book after it's no longer needed. Confirm the phone book ID before calling.
Input parameters
Unique identifier of the phone book to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DELETE_PHONE_BOOK_ENTRYTool to delete a phone book entry. Use when you need to remove a specific entry from a phone book. Confirm both phone_book_id and entry_id before calling.
Input parameters
ID of the specific phone book entry to delete
ID of the phone book containing the entry to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DELETE_SIMULATION_CASETool to delete a simulation case by ID. Use after confirming the simulation case ID to remove it permanently.
Input parameters
Unique identifier of the simulation case to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DELETE_SIMULATION_SCENARIOTool to delete an existing simulation scenario. Use after confirming the scenario ID. Example: Delete simulation scenario with ID '41fc8c4a-b372-4309-813a-545505b2d0e5'.
Input parameters
Unique identifier of the simulation scenario to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DELETE_SIMULATION_SUITETool to delete a simulation suite by ID. Use when you need to remove a simulation suite that is no longer needed. Confirm the suite ID before calling.
Input parameters
The unique identifier of the simulation suite to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DELETE_SUBACCOUNTTool to delete an existing subaccount. Use after confirming the subaccount ID. Example: Delete subaccount with ID 'test_subaccount_id_12345'.
Input parameters
Unique identifier of the subaccount to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DELETE_TEAMTool to delete an existing team. Use when you need to remove a Synthflow AI team after it's no longer needed. Confirm the team ID before calling.
Input parameters
ID of the team to delete, copyable from the UI
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DETACH_ACTIONTool to detach one or more actions from an AI assistant. Use when you need to remove specific actions from an agent's configuration.
Input parameters
Array of action IDs to detach (IDs found in Synthflow dashboard)
The ID of the agent you want to detach an action from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DETACH_KNOWLEDGE_BASETool to detach a knowledge base from an AI assistant. Use when you need to remove a knowledge base association from an agent.
Input parameters
ID of the agent from which the knowledge base needs to be detached
Unique identifier of the knowledge base to detach
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DETACH_MEMORY_STORE_CONTACTTool to detach a contact from a memory store. Use when you need to remove a contact from a specific memory store.
Input parameters
Unique identifier of the contact to detach from the memory store
Unique identifier of the memory store from which to detach the contact
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_DETACH_MEMORY_STORE_FROM_AGENTTool to detach a memory store from an agent. Use when you need to remove a memory store from a specific agent/assistant.
Input parameters
Unique identifier of the agent (assistant) from which to detach the memory store
Unique identifier of the memory store to detach from the agent
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_EXECUTE_SIMULATION_SUITETool to execute all test cases in a simulation suite. The suite runs on the target agent (must match the suite's model_id). Use when you need to validate an agent's performance against pre-configured test scenarios.
Input parameters
UUID identifying the simulation suite to execute
Maximum number of turns per test case. Defaults to 20 if not specified.
Agent ID to run the suite against. Must correspond to the suite's existing model_id.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_EXPORT_ANALYTICSTool to export analytics data for calls within a specified date range. Use when you need to retrieve call analytics, filter by assistant/agent, call type, or time period. Defaults to past 7 days if no dates specified; maximum date range is 120 days.
Input parameters
End date for analytics export in ISO 8601 date-time format (e.g., 2025-11-25T14:30:00Z). Defaults to current time if omitted.
Agent identifier to filter analytics for a specific assistant. Can be found on the agent dashboard page.
Start date for analytics export in ISO 8601 date-time format (e.g., 2025-11-20T14:30:00Z). Defaults to past 7 days if omitted. Maximum date range is 120 days.
Type of call for filtering analytics.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_GET_ACTIONTool to retrieve metadata about a specific action by its ID. Use when you need to inspect an action's configuration and parameters.
Input parameters
Unique identifier of the action to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_GET_ASSISTANTTool to retrieve details of a specific AI assistant. Use after confirming the assistant's ID to fetch its configuration and metadata.
Input parameters
Unique identifier of the AI assistant to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_GET_CALLTool to retrieve the transcript and detailed metadata for a specific phone call. Use when you need to access call recordings, transcripts, duration, or telephony details for a completed call.
Input parameters
Unique identifier of the call to retrieve transcript and metadata for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_GET_CONTACTTool to retrieve details of a specific contact by its ID. Use when you need to fetch contact information.
Input parameters
Unique identifier of the contact to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_GET_KNOWLEDGE_BASETool to retrieve details of a specific knowledge base by its ID. Use after confirming the knowledge base ID to fetch its metadata.
Input parameters
Unique identifier of the knowledge base to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_GET_MEMORY_STORETool to retrieve details of a specific memory store by its ID. Use when you need to fetch metadata and configuration of an existing memory store.
Input parameters
Unique identifier of the memory store to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_GET_MEMORY_STORE_CONTACT_DATATool to retrieve memory data for a specific contact in a memory store. Use when you need to fetch stored memory information associated with a particular contact.
Input parameters
Unique identifier of the contact
Unique identifier of the memory store
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_GET_NUMBERSTool to retrieve a list of phone numbers associated with a workspace. Use when you need to fetch numbers assigned to your account for a given workspace.
Input parameters
Number of phone numbers per page (defaults to 50)
Zero-based index of first phone number to return (defaults to 0)
Unique identifier of the workspace to list phone numbers for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_GET_SIMULATIONTool to retrieve details of a specific simulation by ID. Use to fetch simulation results including timeline, recording, and success criteria evaluation after a simulation has been executed.
Input parameters
Unique identifier of the simulation to retrieve details for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_GET_SIMULATION_CASETool to retrieve a simulation case by ID. Use when you need to fetch details of a specific simulation case including its prompt, success criteria, and metadata.
Input parameters
Unique identifier (UUID) of the simulation case to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_GET_SIMULATION_SCENARIOTool to retrieve a simulation scenario by ID. Use when you need to fetch details of a specific simulation scenario template.
Input parameters
Unique identifier of the simulation scenario to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_GET_SIMULATION_SUITETool to retrieve a simulation suite by ID. Use when you need to fetch details about a specific simulation suite including its test cases and associated agent information.
Input parameters
The unique identifier of the simulation suite to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_GET_SUBACCOUNTTool to retrieve detailed metadata about a specific subaccount by ID. Use when you need to fetch subaccount information including permissions, subscription details, and members.
Input parameters
Unique identifier of the subaccount to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_GET_TEAMTool to retrieve details of a specific team by its ID. Use after confirming the team exists to inspect its configuration.
Input parameters
Unique identifier of the team to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_INITIALIZE_ACTIONTool to initialize a custom action with specified variables. Use when you have an action ID and need to initialize it with configuration variables.
Input parameters
The identifier for the custom action to initialize.
Optional array of key-value pairs for action configuration variables.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_ACTIONSTool to list all actions in the workspace. Use when you need to retrieve a paginated list of available actions and their configurations.
Input parameters
Actions displayed per page (defaults to 20 if omitted).
Index of the first action to be returned (defaults to 0).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_ASSISTANTSTool to list all AI assistants associated with the account. Use when you need to retrieve a paginated list of assistants.
Input parameters
Number of assistants to return per page (defaults to 20 if omitted).
Cursor for pagination; starting point for returning assistants (defaults to '0').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_CALLSTool to retrieve call history (call logs) with filtering to check outcomes/statuses after placing calls. Use after making voice calls to list recent calls for a model, filter by phone number/time window, and confirm outcomes like completed/no-answer/busy/failed.
Input parameters
Page size (number of call records to return), defaults to 20
Index of the first call to be returned (for pagination), defaults to 0
End timestamp in milliseconds since epoch to filter calls until
The model/agent identifier whose calls should be returned
Begin timestamp in milliseconds since epoch to filter calls from
Filter by status of the call (e.g., 'completed', 'no-answer', 'busy', 'failed')
Maximum call duration in seconds to filter by
Minimum call duration in seconds to filter by
Phone number in E.164 format to filter calls by (URL-encode leading '+' as %2B)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_CHATSTool to retrieve a list of chats, optionally filtered by agent ID. Use when you need to view chat history or check recent conversations.
Input parameters
Limit the number of chats to return (defaults to 10 if omitted)
Cursor to start from for pagination; use next_cursor from previous response
Filter chats by agent ID to retrieve only chats associated with a specific agent
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_CONTACTSTool to retrieve a list of contacts with optional search filtering. Use when you need to list all contacts or search for specific contacts by phone number.
Input parameters
Optional parameter to search for contacts by phone number
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_MEMORY_STORESTool to list memory stores with optional filtering by title. Use when you need to retrieve all memory stores in a workspace, optionally filtered by search term.
Input parameters
Filters results by the memory store's title
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_PHONE_BOOKSTool to list all phone books in your workspace. Use when you need to retrieve all phone books for organizing contacts in Synthflow AI.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_SIMULATION_CASESTool to list simulation cases with pagination and optional filtering by name or type. Use when you need to retrieve simulation cases for testing agent behavior.
Input parameters
Filter simulation cases by name (case-insensitive search)
Number of simulation cases to return per page
Page number for pagination, starts at 1
Type of simulation case.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_SIMULATION_CASES_BY_AGENTTool to list all simulation cases created for a specific agent. Use when you need to retrieve test scenarios associated with a particular agent ID.
Input parameters
Agent ID whose simulation cases to list
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_SIMULATIONSTool to list simulations with pagination and optional filters. Use when you need to retrieve simulation records, optionally filtered by session ID, status, date range, or target agent.
Input parameters
Status of a simulation.
Maximum creation timestamp to filter until (ISO 8601 datetime format).
Number of records per page (defaults to 10).
Minimum creation timestamp to filter from (ISO 8601 datetime format).
Pagination page number (defaults to 1).
Filter by target agent identifier.
Filter by simulation session ID (UUID format).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_SIMULATION_SCENARIOSTool to list simulation scenarios with pagination and optional filtering. Use when you need to retrieve simulation scenario templates with support for search by name and date range filtering.
Input parameters
Search term for filtering simulation scenario names.
Filter scenarios created on or before this date (ISO datetime format).
Number of items per page (defaults to 10).
Filter scenarios created on or after this date (ISO datetime format).
Page number for pagination (defaults to 1).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_SIMULATION_SESSIONSTool to list simulation sessions with pagination and optional filters. Use when you need to retrieve simulation sessions, optionally filtered by target agent, date range, or paginated results.
Input parameters
Filter by simulation created_at <= end_date. Use ISO 8601 format (e.g., '2024-12-31T23:59:59Z').
Number of items per page. Defaults to 10.
Filter by simulation created_at >= start_date. Use ISO 8601 format (e.g., '2024-01-01T00:00:00Z').
Page number for pagination. Defaults to 1.
Filter sessions by target agent ID. Only sessions for this agent will be returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_SIMULATION_SUITESTool to list simulation suites with pagination and optional filtering. Use when you need to retrieve simulation suites, optionally filtered by model IDs, date range, or search term.
Input parameters
Search term for simulation suite names
Filter by created_at <= end_date (ISO datetime format)
Filter by list of model IDs
Number of items per page (default: 10)
Filter by created_at >= start_date (ISO datetime format)
Page number (default: 1)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_SUBACCOUNTSTool to list all subaccounts associated with the authenticated account. Use when you need to retrieve all subaccounts and their configurations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_TEAMSTool to list assistant teams. Use when you need to retrieve all teams in a workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_VOICESTool to list all text-to-speech voices in a workspace. Use when you need to retrieve voices available for TTS in a given workspace.
Input parameters
Number of voices to return per page (defaults to 50)
Zero-based index of first voice to return (defaults to 0)
Unique identifier of the workspace to list voices for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_LIST_WEBHOOK_LOGSTool to retrieve paginated webhook logs with filtering and search capability. Use when you need to audit webhook delivery, check webhook statuses, troubleshoot failed webhooks, or search for specific webhook events by date range, status, type, or associated call/assistant.
Input parameters
Search query to filter logs by webhook URL, model ID, or other text fields.
Status of webhook log processing.
Filter logs by associated call identifier.
End date filter in ISO 8601 format (e.g., 2025-11-25T14:30:00Z) to retrieve logs up to this date.
Start date filter in ISO 8601 format (e.g., 2025-11-20T14:30:00Z) to retrieve logs from this date onwards.
Number of items per page for pagination, defaults to 20 if omitted.
HTTP method for filtering.
Page number for pagination, defaults to 1 if omitted.
Filter logs by associated assistant/agent identifier.
Type of webhook for filtering.
Workspace identifier to retrieve logs for. Required to scope the query.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_MAKE_VOICE_CALLTool to initiate a real-time voice call via the AI agent. Use when you have the agent ID, customer name, and phone number ready.
Input parameters
Recipient's full name for personalization.
Recipient's phone number in E.164 format (e.g., +15551234567).
Optional override of the default agent prompt for this call.
Optional override of the greeting the agent will use at call start.
Agent ID (from your dashboard).
Optional customer email for appointment booking or follow-up.
Optional customer IANA timezone (e.g., 'America/Los_Angeles').
Optional list of key–value pairs to inject dynamically into the agent prompt.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_START_SIMULATIONTool to start a new simulation using a simulation case. Use when you need to execute a test scenario against an agent to validate its behavior and performance.
Input parameters
Identifier for the agent being tested. Must be a valid UUID.
Optional key-value pairs for dynamic test data injection during simulation execution.
Identifier for the simulation case to execute. Must be a valid UUID.
Optional identifier to group related simulations together. Must be a valid UUID if provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_UPDATE_ACTIONTool to update an existing action in Synthflow AI. Use when you need to modify an action's configuration such as real-time booking, information extraction, live transfer, SMS sending, custom HTTP calls, or custom evaluations. Exactly one action type must be specified in the request along with the action_id.
Input parameters
Send SMS action configuration.
Unique identifier of the action to update
Custom evaluation action configuration.
Custom action configuration for HTTP API calls.
Live transfer action configuration.
Real-time booking action configuration.
Information extractor action configuration. Can be YES_NO, SINGLE_CHOICE, or OPEN_QUESTION type.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_UPDATE_ASSISTANTTool to update an existing assistant’s settings. Use after confirming the assistant exists. Modify settings like name, phone, recording, webhook, or agent configuration.
Input parameters
New name for the assistant
Partial assistant configuration object
Unique ID of the assistant to update
Custom consent prompt text; required if consent_recording is true
Whether to record calls; if omitted retains current setting
Maximum call duration settings
Phone number for outbound calls, e.g. +15551234567
Custom caller ID number to display, e.g. +12345678901
If true, ask caller for consent before recording
Webhook URL to receive call events and transcripts
Disable transcription if true; defaults to false, transcripts will be generated unless explicitly disabled
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_UPDATE_CONTACTTool to update an existing contact in Synthflow AI. Use when you need to modify contact details like name, phone, email, or metadata.
Input parameters
The contact's full name
The contact's email address
Unique identifier of the contact to update
The contact's phone number in E.164 format (e.g., +15551234567)
Additional metadata for the contact as key-value pairs
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_UPDATE_KNOWLEDGE_BASETool to update an existing knowledge base's name or usage conditions. Use after confirming the knowledge base exists.
Input parameters
New designation for the knowledge base
Unique identifier of the knowledge base to update
Specifies when this knowledge base should be utilized during conversations
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_UPDATE_MEMORY_STORETool to update an existing memory store's title and description. Use when you need to modify metadata of a memory store.
Input parameters
New name for the memory store
New description for the memory store
Unique identifier of the memory store to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_UPDATE_SIMULATION_CASETool to update an existing simulation case. Use when you need to modify the name, prompt, success criteria, or evaluation method of a simulation case.
Input parameters
New name for the simulation case
New instructions or scenario for the simulation
New list of evaluation conditions that define successful simulation execution
Determines how success criteria are evaluated.
Unique identifier of the simulation case to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_UPDATE_SIMULATION_SCENARIOTool to update an existing simulation scenario. Use when you need to modify the name or description of a scenario template.
Input parameters
New title for the simulation scenario template
Updated description of what the scenario template should verify
Unique identifier of the simulation scenario to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_UPDATE_SIMULATION_SUITETool to update an existing simulation suite. Use when you need to modify the name or agent model of a simulation suite. At least one of name or model_id must be provided.
Input parameters
New designation for the simulation suite
New agent model identifier for the suite
Unique identifier of the simulation suite to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SYNTHFLOW_AI_UPDATE_TEAMTool to update an existing team. Use after confirming the team exists and you have new configuration values.
Input parameters
New display name for the team assistant
Identifier of the team to update
Phone number in E.164 format for voice integration
HTTPS endpoint to receive post-call data
List of sub-assistants to attach with routing logic
List of sub-assistants to detach by model ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 37 agents privately built on Nagent that already use Synthflow AI.
Build on Nagent
Connect Synthflow AI to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Synthflow AI, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Synthflow AI is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Synthflow AI is connected, you configure its 79 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Synthflow AI steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Synthflow AI event fires, the agent kicks off automatically.
Every Synthflow AI action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Synthflow AI ships with 79 pre-built ai agents actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Synthflow AI together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Synthflow AI-based workflows tailored to your business.