Installation

Configuration Options

Bland Chat Widget

Bland AI

Introducing SMS support, performance optimizations, and platform-wide fixes

May 19, 2025

Latest updates and improvements to our voice-AI platform

May 12, 2025

May 2, 2025

Community & Support

Blog

Enterprise inquiries

Changelog

V1 API Reference

Dashboard

Support

Enterprise rate limits

Integrate Bland within Twilio Studio Flows

Twilio Studio Flow Integration

Geospatial Dialing

Understand how usage is billed, what plans are available, and where to manage your billing details.

Billing & Plans

Custom Twilio Integration

Gain greater control over your AI agent and the conversational flow. [Create a Pathway Now!](https://app.bland.ai/dashboard?page=convo-pathways)

Conversational Pathways

Interact with the real world mid-call using custom tools.

Custom Tools

Send your first phone call

Webhook Signing

Send 1000 phone calls

Webhooks

Use SMS to create a personal contact that a user can call, and text.

Send an AI phone call with your own conversational pathway agent! Links - [Video Tutorial](https://www.loom.com/share/5ce5a84ec97149efad7cf5eff66a93c5?sid=697dc436-53cf-494c-a3e9-a25031df6496) | [Step-by-step web tutorial](https://docs.bland.ai/tutorials/pathways)

Send Call using Pathways (Simple)

Send Call With Task (Simple)

Send an AI phone call with a custom objective and actions.

Send Call

Analyzes a call of calls based using questions and goals.

Analyze Call with AI

Stop Active Call

End all active phone calls on your account.

Stop All Active Calls

Returns a set of metadata for each call dispatched by your account.

List Calls

Retrieve detailed information, metadata and transcripts for a call.

Call Details

Retrieve stream of events that occured during the call.

Event Stream

Retrieve an audio stream for a call recording.

Get Call Recording

Get the corrected transcript from your call's recording.

Get corrected transcripts

Get the post call webhook data for a specific call.

Get Post Call Webhook

Create and send post call webhooks for specified calls.

Create Post Call Webhook

Resend post call webhooks for specified calls.

Resend Post Call Webhook

Analyze the emotional content of a call recording using AI intelligence.

Analyze Call Emotions

Returns a set of information about all the conversational pathways in your account - including the name, description, nodes and edges.

Get All Pathways Information

Returns a set of information about the conversational pathway in your account - including the name, description, nodes and edges.

Get Single Pathway Information

Create Pathway

Update a conversational pathway's fields - including name, description, nodes and edges.

Update Pathway

Delete Pathway

Create an instance of a pathway chat, which can be used to send and receive messages to the pathway.

Create Pathway Chat

Send a message to a pathway and receive a response.

Pathway Chat

Get conversation history for a pathway chat.

Retrieves all versions of a specific pathway, including version number, creation date, name, and latest status.

Get Pathway Versions

Retrieves a specific version of a pathway, including its name, nodes, edges, version number, and latest status.

Get Specific Pathway Version

Promote a pathway version for a pathway ID to either staging or production environment.

Promote Pathway Version

Creates a new version of a specific pathway, including its name, nodes, and edges.

Create Pathway Version

Updates a specific version of a pathway, including its version name, nodes, and edges.

Update Pathway Version

Marks a specific version of a pathway as archived, effectively deleting it from active use.

Delete Pathway Version

Retrieves all folders for the authenticated user, including folder ID, name, and parent folder ID.

Get All Folders

Retrieves all pathways within a specific folder for the authenticated user.

Get Pathways in Folder

Creates a new folder for the authenticated user.

Create Folder

Deletes a specific folder for the authenticated user. The folder must be empty to be deleted.

Delete Folder

Updates the name of a specific folder for the authenticated user.

Update Folder

Moves a pathway to a different folder or to the root level.

Move Pathway

Create a Knowledge Base

Upload a media file as a new knowledge base

Upload Media

Upload a text file as a new knowledge base

Upload Text

Update Knowledge Base

List all knowledge bases in your account.

List Knowledge Bases

View the details for a specific knowledge base.

List Knowledge Base Details

Remove a knowledge base from your account.

Delete Knowledge Base

Purchase a new phone number (inbound/outbound). ($15/mo. subscription using your stored payment method).

Purchase Phone Number

Update your inbound agent's settings, prompt and other details.

Update Inbound Number Details

Retrieves a list of all inbound phone numbers configured for your account, along with their associated settings.

List Numbers

Retrieve settings for your inbound phone number.

Number Details

Clone a Voice

Update the name of an existing cloned voice.

Rename a Voice

Delete a Voice

Retrieves all available voices for your account.

List Voices

Retrieve detailed information about a specific voice.

Voice Details

Publish Cloned Voice

Generate Audio Sample

Create a Custom Tool that can take AI input and call external APIs.

Create a Custom Tool

Change your Custom Tool's parameters and characteristics.

Update Custom Tool

Delete Custom Tool

List Custom Tools

Custom Tool Details

Configure all of the settings for a new web agent.

Create a Web Agent

Update your web agent's settings, prompt and other details.

Update Web Agent Settings

Create a single-use session token for a client to talk with your web agent.

Authorize a Web Agent Call

Delete Web Agent

Retrieves each web agent you've created, along with their settings.

List Web Agents

Integrate your own Twilio account with Bland. See [Custom Twilio Integration](/tutorials/custom-twilio) for more information.

Create Encrypted Key

Disable an encrypted key for a Twilio account integration. See [Custom Twilio Integration](/tutorials/custom-twilio) for more information.

Delete Encrypted Key

Add inbound numbers to Bland from your own Twilio account. See [Custom Twilio Integration](/tutorials/custom-twilio) for more information.

Upload Inbound Phone Numbers

Remove an inbound number that was uploaded through your own Twilio account. See [Custom Twilio Integration](/tutorials/custom-twilio) for more information.

Delete Inbound Phone Number

Create a new batch of calls using direct input.

Create Batch

Retrieve a list of all batches created by your organization.

List Batches

Retrieve metadata for a specific batch. This does not include logs, use the logs endpoint for that.

Get Batch

Get Batch Logs

Stop a batch that is currently running or scheduled.

Stop Batch

List Prompts

Prompt Details

Create and store a prompt for future use.

Create Prompt

Account Details

Create Organization

Delete Organization

Get Organization

Retrieve the list of members in an organization.

Get Organization Members

Retrieve the current version of a specified service for an organization.

Get Organization's Current Service Version

Retrieve a list of available versions for a specified service within an organization.

List Organization's Service Versions

Update the current version of a specified service for an organization.

Update Organization's Service Version

Add or remove members from an organization.

Update Organization Members

Modify the permissions of an existing member within an organization.

Update Organization Member Permissions

Modify specific properties of an organization.

Update Organization Properties

Retrieve a list of organizations the authenticated user is a member of.

Get User Organization Memberships

Remove the authenticated user from an organization.

Leave Organization

Retrieve the current billing details for an organization.

Get Organization Billing Information

Retrieve the recharge amount for an organization's billing.

Get Organization Billing Refill Information

Retrieve all phone numbers configured for SMS, along with their configuration and conversation counts.

List SMS Numbers

Update the SMS configuration for a phone number owned by the authenticated user.

Update SMS Configuration

Send an SMS message from an agent to a user. This creates or resumes a conversation and triggers processing workflows.

Send SMS Message

Retrieve a paginated list of SMS conversations for the authenticated user, with filtering, sorting, and metadata.

List Conversations

Retrieve a single SMS conversation and its messages by its ID

Option	Type	Default	Description
`pathwayId`	string	Required	The ID of the pathway to use for chat
`position`	string	”bottom-right”	Widget position on screen
`offset`	object	`{ x: 20, y: 20 }`	Custom offset from screen edge
`primaryColor`	string	”#151515”	Main widget color
`buttonBackgroundColor`	string	”#151515”	Chat button background color
`headerBackgroundColor`	string	”#151515”	Chat header background color
`chatTitle`	string	”Chat Support”	Title shown in chat window
`iconUrl`	string	-	Custom chat button icon URL
`headerLogoUrl`	string	-	Custom header logo URL
`width`	number	350	Chat container width
`height`	number	500	Chat container height
`buttonSize`	number	60	Chat button diameter

Bland Enterprise

Platform Information

Basic Tutorials

Bland Chat Widget

Installation

Configuration Options

Bland Enterprise

Platform Information

Basic Tutorials

​Installation

​Configuration Options

Installation

Configuration Options