Skip to main content
POST
/
v1
/
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"
  }'

{
  "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
}

Documentation Index

Fetch the complete documentation index at: https://docs.bland.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
authorization
string
required
Your API key for authentication.

​
Body

​
phone_numbers
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"]
​
encrypted_key
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

​
status
string
Can be success or error.
​
data
object
The created custom dialing pool object (present only if status is success).
​
errors
array
Array of error objects (present only if status is error).
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"
  }'

{
  "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
}

​
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