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

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

<ParamField header="encrypted_key" type="string" required>
  The encrypted\_key of the Twilio account you want to upload numbers from.

  Learn more about BYOT [here](/tutorials/custom-twilio).
</ParamField>

### Body

<ParamField body="numbers" type="string[]" required>
  <Expandable title="properties">
    <ParamField 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"]`
    </ParamField>
  </Expandable>
</ParamField>

### Response

<ResponseField name="status" type="string">
  Can be `success` or `error`.
</ResponseField>

<ResponseField name="message" type="string">
  A message saying whether the insertion succeeded, or a helpful message describing why it failed.
</ResponseField>

<ResponseField name="inserted" type="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.
</ResponseField>

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

***

Docs for agents: [llms.txt](/llms.txt)