How do I bulk add or remove call forwarding on phone numbers?




Need to start or stop routing calls from your Bandwidth numbers to an alternative number(s)? This article explains how you can use the Bandwidth Dashboard to add or remove call forwarding on up to 5,000 phone numbers at once. For API instructions, please see our developer docs.

Looking to add call forwarding on a single phone number? Check out how to add or remove call forwarding on a phone number.

Note: You can determine which of your phone numbers have been enabled for call forwarding by looking at the Forwarding To column in your Full Phone Number Details report.

To add or remove call forwarding on phone numbers in bulk:

  1. Log into the Bandwidth Dashboard.
  2. In the top navigation bar, select Numbers and click My Numbers.
  3. Select Line Features and click the download a template .csv file link. This will download the CSV file into your web browser. 

Line Features tab

Note: If you don’t see the file, please make sure your browser is set to allow pop-ups from the Bandwidth Dashboard and try again. If you still can’t locate it, check the Downloads section in your browser or the Downloads folder on your computer.

  1. Once you open the template, you'll see sample data that shows how the file needs to be filled out for various features. Please erase all information in rows 3-6 prior to entering your own. 
  2. In the TN | TN column, enter the phone numbers that you want to forward from. Please use only 10-digit NANP phone numbers with no spaces, dashes, or parentheses.
  3. In the CallForwarding | TN column, enter the phone numbers that you want to forward to. To remove call forwarding on the phone number, enter systemDefault.


  1. Once you're done, save the file in the .csv format and return to the Line Features tab.  
  2. Drag and drop the file into the Choose a .csv file to import field or click Browse to search for it on your computer.
  3. Enter an optional Customer order ID that can be used to identify any orders created as a result of this file import.
  4. Click Import to upload your file.

Note: If you encounter any errors, please double-check that the formatting is correct. Errors may occur due to an incorrect file type (anything other than .csv), spaces in the file name, or formatting issues in the file itself. 

Questions? Please open a ticket with your Bandwidth Support Team or hit us up at (855) 864-7776!

Article is closed for comments.