Bolna

35 tools available

Create conversational voice agents using Bolna AI to enhance interactions, streamline operations and automate support.

Connect Bolna to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Bolna's 35 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.

Common workflows with Bolna

Trigger on event

Listen for a new event
Parse and validate the payload
Take an action with the linked tool

Daily summary

Pull yesterday's activity
Summarise with the model of your choice
Send the digest via email or Slack

Cross-tool sync

Read records from one app
Transform with a persona
Write the result back via this integration

Bolna actions 35

Every Bolna action below is a callable tool any Definable persona can invoke.

Add Provider to Bolna

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

Copy Bolna Agent

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

Create Bolna Voice AI Agent (v2)

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

Create Bolna Batch

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

Create Bolna Knowledgebase

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

Create Template Agent

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

Delete agent by id

Permanently delete a Voice AI agent and all associated data including batches, executions, and configurations

Delete batch by id

Permanently delete a batch campaign by its ID, removing it from the system. This operation cannot be undone.

Delete Knowledgebase

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

Fetch all batches by agent id

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

Get Agent (v1 - Deprecated)

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

Get all agents

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

Get execution by id

Retrieve 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

Get knowledgebase by ID

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

Get User Information

Tool to retrieve information about the authenticated user. Use when you need details like name, email, wallet balance, or concurrency limits for the current user.

Import Bolna Agent

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

List agents (paginated)

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

List Knowledgebases

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

List all phone numbers

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

List all providers

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

List available voices

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

Make an outbound phone call from agent

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

Partially Update Bolna Voice AI Agent (v1)

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

Remove Provider from Bolna Account

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

Retrieve agent by id

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

Retrieve agent execution details

Retrieve detailed information about a specific execution (call/conversation) by an agent, including transcript, costs, duration, status, and telephony data

Retrieve agent execution status

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

Retrieve Batch Details by ID

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

Retrieve batch execution list

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

Schedule Batch by ID

Schedule 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').

Search available phone numbers

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

Setup inbound call for agent

Add agent for inbound calls

Stop Agent Calls

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

Stop batch by id

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

Update Bolna Voice AI Agent (v2)

Tool 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).

Frequently asked questions

What can I automate with Bolna on Definable?

Anything Bolna exposes through its API. Common ai agents workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 35 Bolna tools directly, then chain the result into another integration without you writing code.

How does Bolna authentication work?

Bolna uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Bolna integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 35 Bolna tools. You only need a separate Bolna subscription if Bolna itself charges per seat or per API call.

Is using Bolna through Definable secure?

Every call from a persona to Bolna is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Bolna on Definable?

Sign up for Definable, open the integrations page, find Bolna, and connect via OAuth or API key. You can immediately attach Bolna to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Bolna actions does Definable expose?

Definable exposes all 35 Bolna actions as callable tools — including `Add Provider to Bolna`, `Copy Bolna Agent`, `Create Bolna Voice AI Agent (v2)`, plus 32 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Bolna?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations