# Bolna

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

- **Category:** ai agents
- **Auth:** API_KEY
- **Tools:** 18
- **Triggers:** 0
- **Slug:** `BOLNA`
- **Version:** 20260211_00

## Tools

### Create Bolna Voice AI Agent (v2)

**Slug:** `BOLNA_CREATE_AGENT`

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

**Slug:** `BOLNA_CREATE_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.

### Delete agent by id

**Slug:** `BOLNA_DELETE_AGENT_BY_ID`

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

### Delete batch by id

**Slug:** `BOLNA_DELETE_BATCH_BY_ID`

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

### Fetch all batches by agent id

**Slug:** `BOLNA_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 all agents

**Slug:** `BOLNA_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 all phone numbers

**Slug:** `BOLNA_GET_ALL_PHONE_NUMBERS`

Retrieve all phone numbers associated with your account, including details like phone number, telephony provider (Twilio, Plivo, Vonage), associated agent ID, creation/update timestamps, renewal date, monthly price, and rental status.

### Get execution by id

**Slug:** `BOLNA_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

### Make an outbound phone call from agent

**Slug:** `BOLNA_MAKE_A_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.

### Retrieve agent by id

**Slug:** `BOLNA_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

**Slug:** `BOLNA_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

**Slug:** `BOLNA_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

**Slug:** `BOLNA_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

**Slug:** `BOLNA_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

**Slug:** `BOLNA_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

**Slug:** `BOLNA_SEARCH_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

**Slug:** `BOLNA_SETUP_INBOUND_CALL_FOR_AGENT`

Add agent for inbound calls

### Stop batch by id

**Slug:** `BOLNA_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.
