> ## 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.

# Upload Inbound Phone Numbers

> Add inbound numbers to Bland from your own Twilio account. See [Custom Twilio Integration](/tutorials/custom-twilio) for more information.

### 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](https://docs.bland.ai/tutorials/custom-twilio.md).

### Body

**numbers** `string[]` *required*

**properties**

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.

```json theme={null}
{
  "status": "success",
  "message": "Successfully inserted numbers",
  "inserted": [
    "+12223334444",
    "+13334445555"
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.