Create Custom Dialing Pool

curl -X POST "https://us.api.bland.ai/v1/custom-dialing-pools" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000"
  }'

const response = await fetch('https://us.api.bland.ai/v1/custom-dialing-pools', {
  method: 'POST',
  headers: {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    phone_numbers: ['+12345678901', '+19876543210', '+15551234567'],
    encrypted_key: '550e8400-e29b-41d4-a716-446655440000'
  })
});

const data = await response.json();
console.log(data);

import requests

url = "https://us.api.bland.ai/v1/custom-dialing-pools"
headers = {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

{
  "status": "success",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "owner_id": "550e8400-e29b-41d4-a716-446655440002",
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000",
    "created_at": "2024-01-15T10:30:00Z"
  },
  "errors": null
}

{
  "status": "error",
  "data": null,
  "errors": [
    {
      "error": "INVALID_PHONE_NUMBERS",
      "message": "All phone numbers must be valid US numbers with +1 prefix"
    }
  ]
}

{
  "status": "error",
  "data": null,
  "errors": [
    {
      "error": "INVALID_CREDENTIALS",
      "message": "Twilio credentials not found or do not belong to your account"
    }
  ]
}

POST

custom-dialing-pools

curl -X POST "https://us.api.bland.ai/v1/custom-dialing-pools" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000"
  }'

const response = await fetch('https://us.api.bland.ai/v1/custom-dialing-pools', {
  method: 'POST',
  headers: {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    phone_numbers: ['+12345678901', '+19876543210', '+15551234567'],
    encrypted_key: '550e8400-e29b-41d4-a716-446655440000'
  })
});

const data = await response.json();
console.log(data);

import requests

url = "https://us.api.bland.ai/v1/custom-dialing-pools"
headers = {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

{
  "status": "success",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "owner_id": "550e8400-e29b-41d4-a716-446655440002",
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000",
    "created_at": "2024-01-15T10:30:00Z"
  },
  "errors": null
}

{
  "status": "error",
  "data": null,
  "errors": [
    {
      "error": "INVALID_PHONE_NUMBERS",
      "message": "All phone numbers must be valid US numbers with +1 prefix"
    }
  ]
}

{
  "status": "error",
  "data": null,
  "errors": [
    {
      "error": "INVALID_CREDENTIALS",
      "message": "Twilio credentials not found or do not belong to your account"
    }
  ]
}

Enterprise Feature - Custom dialing is only available on Enterprise plans. Contact your Bland representative for access.

Custom dialing pools allow you to create collections of phone numbers that will be automatically selected based on geographic proximity to optimize call pickup rates.

Headers

string

required

Your API key for authentication.

Body

array

required

Array of phone numbers to include in the pool. All numbers must be valid US phone numbers with +1 prefix.Format: Each phone number must be exactly 12 characters: +1 followed by 10 digits.Example: ["+12345678901", "+19876543210"]

string

Optional UUID of Twilio credentials to associate with this pool. If provided, must be valid credentials that belong to your account.Format: UUID format (e.g., 550e8400-e29b-41d4-a716-446655440000)Learn more about BYOT here.

Response

string

Can be success or error.

object

The created custom dialing pool object (present only if status is success).

Show data properties

string

Unique identifier for the pool.

string

Organization ID that owns this pool.

array

Array of phone numbers in the pool.

string

UUID of associated Twilio credentials (or null if none).

string

Timestamp when the pool was created.

array

Array of error objects (present only if status is error).

Show error object properties

string

Error code indicating the type of error.

string

Human-readable error message.

curl -X POST "https://us.api.bland.ai/v1/custom-dialing-pools" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000"
  }'

const response = await fetch('https://us.api.bland.ai/v1/custom-dialing-pools', {
  method: 'POST',
  headers: {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    phone_numbers: ['+12345678901', '+19876543210', '+15551234567'],
    encrypted_key: '550e8400-e29b-41d4-a716-446655440000'
  })
});

const data = await response.json();
console.log(data);

import requests

url = "https://us.api.bland.ai/v1/custom-dialing-pools"
headers = {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

{
  "status": "success",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "owner_id": "550e8400-e29b-41d4-a716-446655440002",
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000",
    "created_at": "2024-01-15T10:30:00Z"
  },
  "errors": null
}

{
  "status": "error",
  "data": null,
  "errors": [
    {
      "error": "INVALID_PHONE_NUMBERS",
      "message": "All phone numbers must be valid US numbers with +1 prefix"
    }
  ]
}

{
  "status": "error",
  "data": null,
  "errors": [
    {
      "error": "INVALID_CREDENTIALS",
      "message": "Twilio credentials not found or do not belong to your account"
    }
  ]
}

Usage with Calls

Once you’ve created a custom dialing pool, you can use it in your call requests by specifying the custom_dialing parameter:

{
  "phone_number": "+12345678901",
  "task": "Your call task here",
  "custom_dialing": "550e8400-e29b-41d4-a716-446655440001"
}

The system will automatically select the most geographically appropriate phone number from your pool to maximize pickup rates.

Docs for agents: llms.txt

⌘I

Basic Tutorials

Calls

Voices & Text to Speech

Conversational Pathways

Knowledge Bases

Numbers

Blocked Numbers

Widgets

Tools

Contacts

Memory

Node tests

Agent Testing

Evals

Guard Rails

Web Agents

Live Translation

Custom Twilio Accounts

Batches

Prompts

Account

Organizations

Messaging

SIP Trunks

Custom Dialing Pools

Personas

Citation Schemas

Alarms

Triage

Create Custom Dialing Pool

Headers

Body

Response

Usage with Calls

The system will automatically select the most geographically appropriate phone number from your pool to maximize pickup rates.

​Headers

​Body

​Response

​Usage with Calls

​The system will automatically select the most geographically appropriate phone number from your pool to maximize pickup rates.

Headers

Body

Response

Usage with Calls

The system will automatically select the most geographically appropriate phone number from your pool to maximize pickup rates.