Create conversational voice agents using Bolna AI to enhance interactions, streamline operations and automate support.
Create conversational voice agents using Bolna AI to enhance interactions, streamline operations and automate support. On Nagent, Bolna is exposed as a fully-configurable ai agents integration that any agent can call — 35 actions, and API key authentication. No code is required to wire Bolna into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Bolna 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 Bolna 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 Bolna, with input parameters and output schema. Drop these into any step of an agent built in Helix.
BOLNA_ADD_PROVIDERTool to add a new telephony or voice service provider to your Bolna account. Use when you need to configure API keys for providers like Twilio, Deepgram, or ElevenLabs before creating agents.
Input parameters
User ID to associate the provider with. Optional.
Name of the telephony or voice service provider to add (e.g., 'twilio', 'deepgram', 'elevenlabs')
Flag indicating if this is an API request. Defaults to false.
API key or authentication value for the provider
Sub-account ID to associate the provider with. Optional.
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
BOLNA_COPY_AGENTTool to create a duplicate copy of an existing Bolna voice AI agent. Use when you need to replicate an agent's complete configuration (tasks, prompts, LLM settings, etc.) with a new name.
Input parameters
Optional user identifier to associate the copied agent with a specific user
The unique identifier (UUID) of the existing Bolna agent to copy
The name for the new copied agent. This will be the display name of the duplicated agent.
Flag to indicate if this is an API request. Defaults to false if not 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
BOLNA_CREATE_AGENTTool to create a new Bolna Voice AI agent using the v2 API. Use when you need to set up a new conversational agent from scratch with custom LLM, synthesizer, transcriber, and task configurations. This fills the gap for end-to-end agent setup in workflows starting from an empty account state.
Input parameters
Complete agent configuration object. Required fields: agent_name (string), agent_type (string: 'other', 'sales', 'support', etc.), agent_welcome_message (string), webhook_url (string URL for callbacks), and tasks (array). Each task must include task_type ('conversation', 'extraction', or 'summarization'), toolchain (with execution mode and pipelines), tools_config (defining input/output providers, transcriber, llm_agent, and synthesizer), and task_config (with settings like hangup_after_silence).
Object containing prompt configurations for each task. Each task key (e.g., 'task_1', 'task_2') maps to an object with a 'system_prompt' string that defines behavioral instructions for that task.
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
BOLNA_CREATE_BATCHTool to create a new outbound calling batch by uploading a CSV of contacts to obtain a batch_id. Use when initiating a batch campaign; follow by calling BOLNA_SCHEDULE_BATCH_BY_ID to schedule execution.
Input parameters
CSV file containing contact numbers and prompt variable details for batch execution.
The ID of the agent (UUID format) to use for the batch calling campaign
Phone number in E.164 format (e.g., '+19876543007') to use as the caller ID when initiating batch calls. If not provided, system defaults will be used.
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
BOLNA_CREATE_KNOWLEDGEBASETool to create a new knowledgebase for Voice AI agents to reference during conversations. Use when you need to provide agents with domain-specific knowledge from PDFs or web URLs. Note: Initially returns status 'processing'; poll or wait for status to become 'processed' before use.
Input parameters
URL to ingest as the knowledgebase source (e.g., 'https://example.com/documentation'). Either 'url' or 'file' must be provided, but not both. Use this for web-based content.
PDF file to upload as the knowledgebase source. Either 'file' or 'url' must be provided, but not both.
Optional user identifier to associate with this knowledgebase
Size of text chunks to split the content into for vector embeddings. Larger chunks preserve more context but may reduce retrieval precision. Typical values: 200-1000.
Number of characters to overlap between consecutive chunks. Overlapping helps preserve context across chunk boundaries. Typical values: 50-200.
Internal flag to indicate if this is an API request. Typically not needed by end users.
Optional sub-account identifier for multi-tenant environments
Number of most similar chunks to retrieve during agent queries. Higher values provide more context but may include less relevant information. Typical values: 1-10.
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
BOLNA_CREATE_TEMPLATE_AGENTTool to create a new Bolna Voice AI agent from a template. Use when you want to quickly set up an agent using predefined templates instead of building from scratch.
Input parameters
System prompt or instructions that define the agent's behavior and responses. This guides how the agent interacts with users.
Optional user ID to associate with the template agent
Name for the template agent being created. This will identify the agent in the system.
Type or category of the agent template. Specifies the functional role of the agent (e.g., 'support', 'sales', 'other').
Flag indicating whether to enable transcript recording for this agent. Set to true to capture conversation transcripts.
Name of the business for which the template agent is being created
Flag indicating whether to return the generated prompt in the response. Set to true to receive the prompt back after agent creation.
Dictionary of custom variables that can be used in the agent template. Allows dynamic substitution of values in prompts and configurations. Keys and values should be strings.
Description of the business for which the agent template is being created. Provides context about the business domain and purpose.
Optional flag indicating if this is an API request. Accepts string representation of boolean (e.g., 'true', 'false'). Default is 'false' if not provided.
Identifier or name of the base template to use for agent creation. References a predefined agent template.
Details about the services offered by the business. Helps the agent understand what services it can discuss with customers.
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
BOLNA_DELETE_AGENT_BY_IDPermanently delete a Voice AI agent and all associated data including batches, executions, and configurations
Input parameters
Unique identifier (UUID) of the agent to delete. WARNING: This will permanently delete ALL agent data including all batches, executions, and 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
BOLNA_DELETE_BATCH_BY_IDPermanently delete a batch campaign by its ID, removing it from the system. This operation cannot be undone.
Input parameters
Unique identifier (UUID format) of the batch to delete. This will permanently remove the batch and cannot be undone.
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
BOLNA_DELETE_KNOWLEDGEBASETool to permanently delete a knowledgebase from your Bolna account. Use when you need to remove an existing RAG knowledgebase that is no longer needed. This operation cannot be undone.
Input parameters
Unique identifier (UUID format) of the knowledgebase to delete. This will permanently remove the knowledgebase and cannot be undone.
Optional user identifier to scope the deletion operation to a specific user account
Flag indicating whether this is an API request. Typically omitted or set to false for standard operations
Optional sub-account identifier for multi-tenant or organization scenarios
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
BOLNA_FETCH_ALL_BATCHES_BY_AGENT_IDRetrieve all batches associated with a specific Bolna Voice AI agent. Returns a comprehensive list of batches with details including batch status (scheduled, created, queued, executed), creation and scheduled times, contact counts, file names, and execution status breakdown. Use this to monitor batch campaigns, track their progress, and manage outbound calling operations for the agent.
Input parameters
The unique identifier (UUID) of the Bolna Voice AI agent whose batches you want 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
BOLNA_GET_AGENT_V1\[DEPRECATED\] Retrieve Voice AI agent details using the v1 API endpoint. Use GET /v2/agent/{agent_id} (retrieve_agent_by_id) instead for current implementations. This action returns agent configuration including name, type, status, tasks, and prompts.
Input parameters
Optional user identifier to filter agents by user ownership.
The unique identifier (UUID) of the Bolna voice agent to retrieve. You can get valid agent IDs from the get_all_agents action.
Flag indicating if this is an API request. Defaults to false if not provided.
Optional sub-account identifier for multi-tenant scenarios.
Optional version identifier to retrieve a specific version of 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
BOLNA_GET_ALL_AGENTSRetrieve all agents configured in your Bolna account Returns a comprehensive list of all voice agents with their configurations including: - Agent metadata (ID, name, type, status) - Task configurations (conversation settings, toolchains) - AI model settings (LLM, transcriber, synthesizer) - Webhook and phone number assignments - System prompts and guardrails This is useful for listing available agents, checking agent configurations, or finding specific agents by their properties.
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
BOLNA_GET_EXECUTION_BY_IDRetrieve detailed information about a specific phone call execution by its ID. Returns comprehensive execution data including conversation transcript, duration, costs (LLM, TTS, STT, network, platform), telephony details (phone numbers, recording URL, provider info), usage metrics (tokens, characters, duration), and extracted structured data. Use this to: - Analyze individual call performance and outcomes - Access conversation transcripts and recordings - Review cost breakdowns and resource usage - Monitor call status and error messages - Retrieve extracted structured data from conversations
Input parameters
The unique execution identifier (UUID format, e.g., '4c06b4d1-4096-4561-919a-4f94539c8d4a')
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
BOLNA_GET_KNOWLEDGEBASETool to retrieve details of a specific knowledgebase by its ID. Returns complete configuration including processing status, file information, vector ID, and embedding parameters (chunk size, similarity top k, overlapping). Use when you need to check if a knowledgebase has finished processing or to inspect its configuration before using it with an agent.
Input parameters
The unique identifier (UUID) of the knowledgebase to retrieve
Optional user ID for filtering knowledgebase access
Flag indicating if this is an API request
Optional sub-account ID for multi-tenant scenarios
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
BOLNA_GET_USER_INFOTool to retrieve information about the authenticated user. Use when you need details like name, email, wallet balance, or concurrency limits for the current user.
Input parameters
Optional user ID to fetch information for a specific user
Flag to indicate if this is an API request
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
BOLNA_IMPORT_AGENTTool to import an existing Bolna voice AI agent by its ID. Use when you need to copy or duplicate an agent configuration, create a new agent from a template, or migrate an agent from another environment.
Input parameters
Optional user identifier to associate with the imported agent
The unique identifier (UUID format) of the agent to import
Optional name to assign to the imported agent. If not provided, the original agent name will be used.
Flag indicating whether this is an API request. Defaults to false if not provided.
Optional sub-account identifier for multi-tenant environments
Optional version identifier (UUID format) of the specific agent version to import. If not provided, the latest version will be imported.
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
BOLNA_LIST_AGENTS_PAGINATEDTool to retrieve a paginated list of all agents in your Bolna account. Use when you need to fetch agents with optional filtering by user_id or sub_account_id.
Input parameters
Filter agents by specific user ID
Number of agents to return per page. Defaults to API default if not specified.
Page number for pagination (1-based). Defaults to 1 if not specified.
Flag to indicate if this is an API request. Accepts string representation of boolean.
Filter agents by sub-account ID for multi-tenant scenarios
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
BOLNA_LIST_KNOWLEDGEBASESTool to retrieve all knowledgebases from your Bolna account. Use when you need to view available RAG knowledgebases, check their processing status, or find specific knowledgebases by status.
Input parameters
Status of a knowledgebase
Optional user identifier to filter knowledgebases by a specific user account
Number of knowledgebases to return per page. Defaults to API default if not specified.
Page number for pagination (1-based). Defaults to 1 if not specified.
Flag indicating whether this is an API request. Typically omitted or set to false for standard operations
Optional sub-account identifier for multi-tenant or organization scenarios
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
BOLNA_LIST_PHONE_NUMBERSTool to list all phone numbers associated with your Bolna account. Use when you need to retrieve details of all phone numbers including provider, associated agent, pricing, and rental status.
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
BOLNA_LIST_PROVIDERSRetrieve all providers associated with your Bolna account Returns a list of all configured providers including: - Provider IDs (unique identifiers) - Provider names (e.g., API key types) - Masked provider values (secrets) - Creation timestamps (both absolute and human-readable) Use this when you need to view all configured API providers, check provider details, or verify provider setup in your Bolna account.
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
BOLNA_LIST_VOICESTool to list all available voices that can be utilized for Voice AI agents. Use when you need to see which voices are available across different providers.
Input parameters
Optional user ID to filter voices for a specific user
Optional flag to indicate if this is an API request
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
BOLNA_MAKE_A_PHONE_CALL_FROM_AGENTInitiate an outbound phone call using a configured Bolna Voice AI agent. The agent will call the specified recipient and engage in a conversation based on its configured prompt and capabilities.
Input parameters
The UUID of the Bolna agent that will initiate and handle the outbound call. Use get_all_agents to retrieve available agent IDs.
Optional dictionary of custom variables that can be referenced in the agent's prompt template. Keys should match variable names in your agent configuration. Example: {'customer_name': 'John', 'order_id': '12345'}
Optional caller ID phone number in E.164 format (e.g., +14155559999). If not provided, Bolna will use a default shared number. Required only when using dedicated or connected phone numbers.
The recipient's phone number in E.164 international format (e.g., +14155552671 for US, +919876543210 for India). Must include the + prefix and country code.
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
BOLNA_PATCH_AGENT_V1Tool to partially update a Voice AI agent using the v1 API endpoint. Use when you need to modify specific agent properties like name, welcome message, webhook URL, synthesizer settings, or system prompts without providing the full configuration. Note: This is a deprecated v1 endpoint; prefer using PATCH /v2/agent/{agent_id} for new implementations.
Input parameters
User identifier for multi-tenant scenarios
Unique identifier (UUID) of the agent to update. Also known as agent_id.
Schema for agent configuration
Schema for agent prompts configuration
Flag indicating if this is an API request
Sub-account identifier for organizational hierarchy
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
BOLNA_REMOVE_PROVIDERTool to remove a provider from your Bolna account by its key name. Use when you need to delete a provider configuration that is no longer needed or needs to be replaced.
Input parameters
Optional user ID to scope the provider removal to a specific user
Flag to indicate if this is an API request. Defaults to false if not specified
Optional sub-account ID to scope the provider removal to a specific sub-account
The unique key name of the provider to remove from your account (e.g., 'TEST_PROVIDER')
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
BOLNA_RETRIEVE_AGENT_BY_IDRetrieve complete configuration and details for a specific Bolna voice AI agent by its ID. Returns comprehensive agent information including name, type, status, conversation tasks, LLM/synthesizer/transcriber settings, system prompts, webhook configuration, and timestamps. Use this to inspect agent setup before making calls or to verify agent configuration.
Input parameters
The unique identifier (UUID) of the Bolna voice agent to retrieve. You can get valid agent IDs from the get_all_agents action.
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
BOLNA_RETRIEVE_AGENT_EXECUTION_DETAILSRetrieve detailed information about a specific execution (call/conversation) by an agent, including transcript, costs, duration, status, and telephony data
Input parameters
The unique agent ID (UUID format)
The unique execution ID for the call/conversation (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
BOLNA_RETRIEVE_AGENT_EXECUTION_STATUSRetrieve all executions for a specific agent with pagination and filtering support. Returns a paginated list of agent execution records including call status, cost breakdown, transcripts, and telephony data.
Input parameters
Filter executions where created_at is less than or equal to this UTC datetime (ISO 8601 format)
Filter executions where created_at is greater than or equal to this UTC datetime (ISO 8601 format)
Filter by call status (e.g., queued, ringing, completed, failed)
The unique UUID of the agent whose executions you want to retrieve
Filter executions by specific batch ID
Filter by conversation provider (e.g., plivo, twilio, websocket, web-call)
Filter by call type: 'inbound' or 'outbound'
Number of results per page (maximum: 50, default: 20)
Page number to retrieve (minimum: 1, default: 1)
Filter by whether the call was answered by voicemail
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
BOLNA_RETRIEVE_BATCH_DETAILS_BY_IDRetrieve comprehensive details about a specific Bolna batch by its ID. Returns batch metadata including creation time, execution status, scheduled time, contact statistics, and call status breakdown. Use this to monitor batch progress or retrieve information about previously created batch calling campaigns.
Input parameters
Unique identifier of the batch in 32-character hex format (e.g., '3c90c3cc0d444b5088888dd25736052a')
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
BOLNA_RETRIEVE_BATCH_EXECUTION_LISTRetrieve all executions from a specific batch with pagination support. Returns detailed information about each call execution including conversation metrics, transcripts, costs, and resource usage breakdown (LLM tokens, synthesizer characters, etc.). Use this to monitor batch campaign results and analyze individual call outcomes.
Input parameters
The unique identifier of the batch (32-character hex string)
Number of results per page (maximum 50)
The page number to retrieve (starts at 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
BOLNA_SCHEDULE_BATCH_BY_IDSchedule a batch to execute at a specific time. After creating a batch with BOLNA_CREATE_BATCH, use this action to set when the batch calls should begin. The batch must exist and be in a schedulable state (e.g., 'created' or 'stopped').
Input parameters
The unique identifier (UUID) of the batch to schedule
The scheduled execution time in ISO 8601 format with timezone. Must be a future timestamp specifying when the batch calls should begin.
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
BOLNA_SEARCH_PHONE_NUMBERSTool to search for available phone numbers that can be purchased for Bolna Voice agents. Use when you need to find purchasable phone numbers by country or prefix pattern before buying.
Input parameters
The country code for the phone number. Available options: US or IN
A 3-character prefix for filtering phone numbers during the search
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
BOLNA_SETUP_INBOUND_CALL_FOR_AGENTAdd agent for inbound calls
Input parameters
Agent `id` which will handle inbound calls. Used as default if no IVR option-level agent is set. Please make sure that the agent"s Telephony provider is set as Twilio
Telephone number `id` from \[Phone number list API\](/api-reference/phone-numbers/get_all). This is required to associate a phone number with the agent for inbound calls.
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
BOLNA_STOP_AGENT_CALLSTool to stop all queued or scheduled calls for a specific Voice AI agent. Use when you need to immediately halt all pending calls for an agent.
Input parameters
Optional user identifier to filter which calls to stop for this agent
Unique identifier (UUID) of the agent whose queued or scheduled calls should be stopped. Obtain this from BOLNA_CREATE_AGENT or BOLNA_GET_ALL_AGENTS.
Optional flag to indicate if this is an API request. Defaults to false if not provided.
Optional sub-account identifier to filter which calls to stop within a multi-tenant setup
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
BOLNA_STOP_BATCH_BY_IDStop a running batch by its ID. This halts all queued calls in the batch. Any calls currently in the queue waiting to be executed will be cancelled and will not be processed. Use this when you need to immediately halt a batch campaign that's in progress.
Input parameters
The unique identifier (UUID or 32-character hex string) of the batch to stop. Obtain this from BOLNA_CREATE_BATCH or BOLNA_FETCH_ALL_BATCHES_BY_AGENT_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
BOLNA_UPDATE_AGENTTool to update all settings and configuration of an existing Bolna Voice AI agent using the v2 API. Use when you need to modify an agent's full configuration including LLM settings, synthesizer, transcriber, tasks, prompts, or any other agent property. This performs a complete update (PUT operation).
Input parameters
Optional user ID parameter for multi-user environments
The unique identifier (UUID) of the agent to update
Complete agent configuration object. Required fields: agent_name (string), agent_type (string: 'other', 'sales', 'support', etc.), agent_welcome_message (string), webhook_url (string URL for callbacks or null), and tasks (array). Each task must include task_type ('conversation', 'extraction', or 'summarization'), toolchain (with execution mode and pipelines), tools_config (defining input/output providers, transcriber, llm_agent, and synthesizer), and task_config (with settings like hangup_after_silence, optimize_latency, etc.).
Object containing prompt configurations for each task. Each task key (e.g., 'task_1', 'task_2') maps to an object with a 'system_prompt' string that defines behavioral instructions for that task.
Flag to indicate if this is an API request. Defaults to false
Optional sub-account ID for multi-tenant scenarios
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 44 agents privately built on Nagent that already use Bolna.
Build on Nagent
Connect Bolna 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 Bolna, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Bolna is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Bolna is connected, you configure its 35 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Bolna 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 Bolna event fires, the agent kicks off automatically.
Every Bolna 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 Bolna ships with 35 pre-built ai agents actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Bolna together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Bolna-based workflows tailored to your business.