Skip to main content
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>"
  ]
}
'
{
  "status": "success",
  "message": "Successfully inserted numbers",
  "inserted": [
    "+12223334444",
    "+13334445555"
  ]
}

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.

​
Headers

​
authorization
string
required
Your API key for authentication.
​
encrypted_key
string
required
The encrypted_key of the Twilio account you want to upload numbers from.Learn more about BYOT here.

​
Body

​
numbers
string[]
required

​
Response

​
status
string
Can be success or error.
​
message
string
A message saying whether the insertion succeeded, or a helpful message describing why it failed.
​
inserted
array
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