POST
/
v1
/
inbound
/
insert
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": [
    {}
  ]
}'
{
  "status": "success",
  "message": "Successfully inserted numbers",
  "inserted": [
    "+12223334444",
    "+13334445555"
  ]
}

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.

Body

numbers
array
required

An array of phone numbers you want to upload to Bland.

Include the leading '+', country code and the phone number without any special characters.

Example: ["+12223334444", "+13334445555"]

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.