Skip to main content

Overview

Users can connect their own Twilio account to Bland, easily bring over your existing phone numbers to use within the platform. Pre-requisites:
  • Your own Twilio account

Step 1: Get your Twilio credentials

  1. Log in to your Twilio Console.
  2. Copy your Account SID (starts with “AC”, 34 characters) and Auth Token (32 characters).
  3. Make sure the phone number(s) you want to use are active in that Twilio account.

Step 2: Generate an Encrypted Key in Bland

  1. In the Bland Dashboard, go to Add-ons → BYOT and generate a new key using your Twilio Account SID and Auth Token.
  2. Save theencrypted_keyimmediately as it is only shown once. If you lose it, you’ll need to generate a new one.

Step 3: Import your Twilio numbers

You can import your Twilio numbers in two different ways: through the dashboard UI, or via API. UI
  1. After the key is generated, your Twilio numbers will appear under Add-ons → BYOT.
  2. Select the number (s) you want to import and complete the import.
API You can also generate yourencrypted_keydirectly via API using the Create Encrypted Key endpoint: Required body params:
  • account_sid - Your Twilio Account SID
  • auth token- Your Twilio Auth Token
Required header:
  • authorization - Your Bland API key
For example:
Note: To disable anencrypted_key, use the Delete Encrypted Key endpoint.

Step 4: Use your imported number

For outbound calls, includeencrypted_keyin the header (in addition to the Authorization header) of your send call API requests, and set to your imported Twilio number (s) as the from number. For example:
Ifencrypted_keyis included butfrom is omitted, Bland will automatically select one of the imported numbers from that Twilio account, if one exists.

Geo-Permissions

International calling permissions for imported numbers are inherited from the Twilio account they came from. Make sure the destination country is enabled in your Twilio account’s Geo Permissions before placing outbound calls there. https://console.twilio.com/?frameUrl=/console/voice/calls/geo-permissions/low-risk https://console.twilio.com/?frameUrl=/console/voice/calls/geo-permissions/high-risk Note: Any future updates to imported BYOT numbers MUST include theencrypted_key, or the request may fail. Docs for agents: llms.txt