Manage your SMS long code number inventory


  • Genesys Cloud CX 1 Digital Add-on II, Genesys Cloud CX 2, Genesys Cloud CX 2 Digital, Genesys Cloud CX 3, or Genesys Cloud CX 3 Digital license
  • SMS > phoneNumber > All permission 

The SMS Number Inventory page provides you with a list of your SMS numbers and the tools to manage them. The column headings on the page instantly allow you to identify the number, its status, the type of number, and the purchase date.

For more information, see Messaging pricing.


The Status column shows either Active or Pending.

  • Active: You can use the number to send SMS messages.
  • Pending: You cannot yet use the number to send SMS messages.
Note: Numbers in Pending status have a tooltip associated with them. Hover over the tooltip to see the message.


If your SMS number inventory contains many numbers, use the Filter feature to narrow your display to only those numbers you want to see.

  1. Click Filter .
  2. After the Filter panel appears, select either Type or Status to narrow the display of SMS numbers.


If you decide that you no longer need a particular SMS number, you can release it.

  1. Choose the number or numbers that you want to release.
    • To release more than one number, select the check box next to each number and click Release Numbers.
    • To release a single number, hover over the row that contains the number and click Remove number from inventory that appears at the end of the row.
  2. When the Confirm Release dialog appears, click Yes, release.
Note: If you attempt to release a number currently associated to a flow, an error appears and you cannot release the number until you unassociate the flow. For more information, see Manage an inbound message route.

If your SMS number inventory contains multiple numbers, you can use the Search feature to find the numbers you want to see.

  1. Type the number that you want to find in the search field.
    • As you type, the search immediately begins processing the results.
    • Do not include parenthesis, spaces, or hyphens in the number–type the number as one continuous string.
  2. To cancel or exit the search and clear the results, click the x in the search box.