Custom Dialing Pools
Create Custom Dialing Pool
Create a new custom dialing pool with phone numbers for optimized call routing.
POST
/
v1
/
custom-dialing-pools
curl -X POST "https://us.api.bland.ai/v1/custom-dialing-pools" \
-H "Authorization: Bearer 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': 'Bearer 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": "Bearer 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.
Headers
Body
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"]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
The created custom dialing pool object (present only if status is
success).curl -X POST "https://us.api.bland.ai/v1/custom-dialing-pools" \
-H "Authorization: Bearer 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': 'Bearer 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": "Bearer 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 thecustom_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.txtWas this page helpful?
⌘I
curl -X POST "https://us.api.bland.ai/v1/custom-dialing-pools" \
-H "Authorization: Bearer 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': 'Bearer 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": "Bearer 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"
}
]
}