Upload Inbound Phone Numbers
curl --request POST \
--url https://api.bland.ai/v1/inbound/insert \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--header 'encrypted_key: <encrypted_key>' \
--data '
{
"numbers": [
"<string>"
]
}
'import requests
url = "https://api.bland.ai/v1/inbound/insert"
payload = { "numbers": ["<string>"] }
headers = {
"authorization": "<authorization>",
"encrypted_key": "<encrypted_key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
authorization: '<authorization>',
encrypted_key: '<encrypted_key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({numbers: ['<string>']})
};
fetch('https://api.bland.ai/v1/inbound/insert', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v1/inbound/insert",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'numbers' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>",
"encrypted_key: <encrypted_key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/inbound/insert"
payload := strings.NewReader("{\n \"numbers\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("encrypted_key", "<encrypted_key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bland.ai/v1/inbound/insert")
.header("authorization", "<authorization>")
.header("encrypted_key", "<encrypted_key>")
.header("Content-Type", "application/json")
.body("{\n \"numbers\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/inbound/insert")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["encrypted_key"] = '<encrypted_key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"numbers\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "Successfully inserted numbers",
"inserted": [
"+12223334444",
"+13334445555"
]
}
Custom Twilio Accounts
Upload Inbound Phone Numbers
Add inbound numbers to Bland from your own Twilio account. See Custom Twilio Integration for more information.
POST
/
v1
/
inbound
/
insert
Upload Inbound Phone Numbers
curl --request POST \
--url https://api.bland.ai/v1/inbound/insert \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--header 'encrypted_key: <encrypted_key>' \
--data '
{
"numbers": [
"<string>"
]
}
'import requests
url = "https://api.bland.ai/v1/inbound/insert"
payload = { "numbers": ["<string>"] }
headers = {
"authorization": "<authorization>",
"encrypted_key": "<encrypted_key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
authorization: '<authorization>',
encrypted_key: '<encrypted_key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({numbers: ['<string>']})
};
fetch('https://api.bland.ai/v1/inbound/insert', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v1/inbound/insert",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'numbers' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>",
"encrypted_key: <encrypted_key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/inbound/insert"
payload := strings.NewReader("{\n \"numbers\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("encrypted_key", "<encrypted_key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bland.ai/v1/inbound/insert")
.header("authorization", "<authorization>")
.header("encrypted_key", "<encrypted_key>")
.header("Content-Type", "application/json")
.body("{\n \"numbers\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/inbound/insert")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["encrypted_key"] = '<encrypted_key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"numbers\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "Successfully inserted numbers",
"inserted": [
"+12223334444",
"+13334445555"
]
}
Headers
Your API key for authentication.
The encrypted_key of the Twilio account you want to upload numbers from.Learn more about BYOT here.
Body
Show properties
Show properties
Response
Can be
success or error.A message saying whether the insertion succeeded, or a helpful message describing why it failed.
An array of phone numbers that were successfully inserted.Any phone numbers that failed to be inserted will not be included in this array - for example if they are already in your account or not associated with the sepcified Twilio account.
{
"status": "success",
"message": "Successfully inserted numbers",
"inserted": [
"+12223334444",
"+13334445555"
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I