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, switch the sidebar selector to All agents and open Phone numbers under Dispatch. Press Connect Twilio and enter your Twilio Account SID and Auth Token. See Dispatch.
- 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 you connect Twilio, press Import numbers on the Phone numbers page.
- 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. Send agent_id to choose the agent that runs the call.
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