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
- Log in to your Twilio Console.
- Copy your Account SID (starts with “AC”, 34 characters) and Auth Token (32 characters).
- Make sure the phone number(s) you want to use are active in that Twilio account.
Step 2: Generate an Encrypted Key in Bland
- In the Bland Dashboard, go to Add-ons → BYOT and generate a new key using your Twilio Account SID and Auth Token.
- Save the
encrypted_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- After the key is generated, your Twilio numbers will appear under Add-ons → BYOT.
- Select the number (s) you want to import and complete the import.
encrypted_keydirectly via API using the Create Encrypted Key endpoint:
Required body params:
account_sid- Your Twilio Account SIDauth token- Your Twilio Auth Token
authorization- Your Bland API key
encrypted_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:
encrypted_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