Skip to main content
POST
https://us.api.bland.ai
/
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
}
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.