Add and Configure a New Phone Number with Twilio Flex

All new Flex projects are automatically assigned a Twilio phone number to begin testing. However, you're not limited to just this number. You can add or remove new phone numbers on your Flex project at any time. Read on for more details.

Acquire a New Twilio Phone Number

Flex numbers only need to support the services you need for your application - Voice, SMS, etc. As long as a phone number fits your needs, it can be acquired in the most convenient method for you:

  • Purchase a new phone number from Twilio
  • Transfer an existing Twilio number from another project
  • Port an existing number from another provider in to Twilio

Purchase a new Twilio phone number

Phone numbers can be purchased via the Console site, or with our REST API. For help purchasing a phone number, please refer to our support articles here:

Transfer an existing Twilio phone number from another project

Twilio phone numbers can be easily moved between different projects by the Twilio Support team. For more information, please see Move or Transfer a Phone Number to your Flex Project.

Port in an existing non-Twilio phone number

Porting an existing non-Twilio number into Twilio can be a time consuming process, but it allows you to continue using a phone number your customers already know. For more information, please see Porting a Phone Number to Twilio.

Configure and Register a Phone Number for Flex

Once a new phone number has been purchased on your Flex project, you will need to configure the number to work with your Flex Voice IVR Studio flow for calls, and the Flex Proxy Service for messages. After this, your number will need to be registered with Flex.

  1. Access the Active Numbers page in Console.
  2. Click your new Flex phone number to modify its configuration. When finished, click Save.
    • Scroll to the Voice & Fax section, and then modify the phone number’s routing:
      Configure the voice settings for your phone number.
      ACCEPT INCOMING Voice Calls
      CONFIGURE WITH Webhooks, TwiML Bins, Functions, Studio, or Proxy
      A CALL COMES IN Studio Flow
      DROP-DOWN MENU Voice IVR
    • Scroll to the Messaging section, and then modify the phone number’s routing:
      Configure the sms settings for your phone number.
      CONFIGURE WITH Webhooks, TwiML Bins, Functions, Studio, or Proxy
      A CALL COMES IN Proxy Service
      DROP-DOWN MENU Flex Proxy Service
  3. Access the Flex Messaging page in Console.
  4. Click Register next to your new phone number.
  5. Your phone number should now be listed under Incoming Message Handlers with the following information:
    CHANNEL sms
    STUDIO FLOW Messaging Flow
  6. Access the Proxy Dashboard page in Console.
  7. Click Proxy Numbers next to "Flex Proxy Service".
  8. Verify your new phone number is listed as a Proxy number.

Remove a Phone Number from Flex

Any phone number can be removed from your Flex project - including the number originally assigned to your project for testing.

  1. Access the Flex Messaging page in Console.
  2. Click the "Delete" garbage can icon next to the phone number you wish to delete from Flex.
  3. Access the Proxy Dashboard page in Console.
  4. Click Proxy Numbers next to "Flex Proxy Service".
  5. Click Remove next to the phone number you wish to delete from Flex.

Notice: Removing a phone number from Flex does not remove this phone number from your Flex project. To continue using this phone number with Twilio, but outside of Flex, you'll need to update the configuration for both incoming calls and incoming SMS messages. To delete this phone number from your Flex project, you must release it.

Have more questions? Submit a request
Powered by Zendesk