Port DID numbers in bulk


  • Genesys Cloud Voice Admin role

Note: The procedure described in this article is specifically for porting numbers in the US and Canada. For more information about porting numbers other countries, see Port DID numbers in EMEA.

When you are porting 500 or more DID numbers into Genesys Cloud Voice, you have to use one of our large batch porting processes rather than entering individual numbers using the Port In DID Numbers feature. You can use the port DID numbers by email procedure or you can use the port DID numbers in bulk procedure described in this article.

To port DID numbers into Genesys Cloud Voice using the bulk procedure, you download a specially formatted .csv file template and add your numbers to it. You then use the Port DID Numbers in Bulk option to upload your .csv file.

Each .csv file can hold a maximum of 500 numbers. So for example, if you have 1000 numbers you want to import, you have to use two .csv files, each with 500 numbers. Likewise, if you have 550 numbers you want to import, you have to use two .csv files – one with 500 numbers and one with 50 numbers.

Warning: If you enter more than 500 numbers in a .csv file, the import process fails.

Contact your existing carrier

Before you submit a request to port numbers to Genesys Cloud Voice, you must work with your existing carrier to determine what information you need from them to begin the port procedure. Having that information beforehand ensures a smooth transition between your existing carrier and Genesys Cloud Voice. Failure to do so, can result in delays.

Tip: Because it can take up to 10 days to know the exact date that your carrier releases your numbers, we recommend that you submit a port request 2–3 weeks in advance. This ensures coverage of the 10 days that it can take to get an exact date and also allows you to prepare for number porting.


Our support technicians are committed to activating your numbers in Genesys Cloud Voice as quickly as possible. However, it is important that you understand that the actual activation is restricted to the hours of 8 a.m. to 7 p.m. Eastern Time, Monday thru Friday.

Port holidays

On specific holidays, DID number porting is unavailable.

Holiday Date
New Year's Day (observed) January 2, 20231
Martin Luther King Jr. Day January 16, 2023
Presidents' Day February 20, 2023
Good Friday April 7, 2023
Memorial Day May 29, 2023
Juneteenth June 19, 2023
Independence Day July 4, 2023
Labor Day September 4, 2023
Columbus Day October 9, 2023
Election Day November 7, 2023
Veterans Day November 10, 2023
Thanksgiving Day November 23, 2023
Day after Thanksgiving November 24, 2023
Christmas Eve (observed) December 25, 2023
Christmas Day (observed) December 26, 2023


There is no fee for the number porting operation. However, once the numbers are ported into Genesys Cloud Voice, you will incur any non-recurring charge (NRC), Monthly recurring charge (MRC), and usage fee associated with having your numbers in Genesys Cloud Voice. For more information, see Genesys Cloud Voice pricing.

SMS services

The Genesys Cloud Voice number porting process is specifically designed for voice service numbers. Any SMS services present on ported numbers will not be automatically transferred along with voice service. In fact, the SMS services will likely be disrupted by the port process.

If you would like to transfer your SMS service to Genesys Cloud along with your voice service, you need to take additional steps after you initiate the porting process. To begin, when you respond to your port submission confirmation email, please use Reply All and add a note to your message informing the team that you would like to port your SMS service along with the voice service. Our team will then begin the SMS service porting process.

If you would like your SMS service to remain with your current carrier, you will need to contact them after the voice port is complete and request that they reconnect the SMS service to the number.

Download the template

  1. Click Admin.
  2. Under Genesys Cloud Voice, click Number Management.
  3. On the Genesys Cloud Voice Number Management page, click the Port Numbers button and select DID.
  4. In the Port DID Numbers in Bulk section, click Download Template to access the .csv template.

Add numbers to the template

Using a text editor, enter your numbers using the e.164 format and the restriction codes exactly as described in the template.

Warning: Do not use a spreadsheet application to add your numbers to the .csv template. Doing so will strip out the leading + on all your e.164 formatted numbers.

Upload your .csv file

  1. In the Port DID Numbers in Bulk section, click Browse, locate the .csv file, and click Open. The .csv file uploads in the background.
  2. You must select or create a location containing the address that Genesys Cloud provides to emergency services in the event an emergency services call is made.
    • To use an existing location, select it from the Location list.
    • To create a new location, click Create a location in the instructions.

When you click Create a location, you are prompted to fill in the Add Location form.

  • In the Name box, type the location name that you want to appear on user profiles.
  • To select a photo for the location, click Choose File. Then select an image file that represents the location on user profiles. You can use any .jpeg, .png, or .gif file. The maximum file size is 10 MB.
  • In the Site Contact box, search for a member of your organization and select their name when it appears in the list.
  • In the Address box, type the location’s street address.
  • Continue specifying the location address by filling in the City, State/Province/Region, and Zip/Postal Code boxes.
  • In the Country list, select your country.
  • In the Notes box, type any additional information about this location.
  • Click Save.
  1. In the Activation Date and Time box, specify when the ported numbers become active.  
    Note: You can use a 15-minute window for the activation time. For example, you can specify 1:00 p.m. or 1:15 p.m. or 1:30 p.m. or 1:45 p.m.
  2. In the Email box, type the email address Genesys can use to contact you for questions.  
  3. In the Contact Phone Number box, type a phone number that Genesys can use to contact you for questions. Do not include spaces, dashes, or parentheses between the digits. Click the flag icon and select the country in which the contact phone number exists.
  4. In the Letter of Authorization Localization panel:
    • Select a Country.
    • If a Letter of Authorization is available in multiple languages for your country, select the language from the Language list.
  5. In the Authorized Contact Name box, type your name or the name of the person who is responsible for the request. 
  6. In the Company Name box, type your company name exactly as it appears on the bill from your current DID service provider.
  7. In the Billing Address boxes, type your billing address exactly as it appears on the bill from your current DID service provider.
  8. Click Confirm.
  9. On the Terms and Conditions page, read through and accept the terms and conditions.
  • For questions or to follow-up on your submission, contact Genesys Cloud Voice support.
  • Snapbacks may not be accepted, so it is crucial that you confirm all porting information before submitting your request.