Manage numbers

After your numbers are approved and activated, manage them through the Infobip web interface or the API. This page covers viewing, configuring, setting up inbound routing, bulk operations, cancellation, and API management.

You need an active Infobip account with approved and activated numbers. See Request resources if you still need to obtain numbers.

View numbers

View all your purchased and imported numbers, their type, status, capabilities, and monthly fees:

1. Log in to your Infobip account.
2. Go to Channels and numbers > Numbers > My numbers.
3. View all your purchased and imported numbers with country, type, capabilities, and monthly fee.
4. Search and filter by country, number type (virtual long number, short code, toll-free, 10DLC), or capability (SMS, MMS, Voice, WhatsApp, WhatsApp Voice).
5. Select a number to open its details page where you can view and configure all settings.

Configure numbers

Set up channel-specific settings, connect to applications for reporting, and manage capabilities:

1. Select the number from My numbers.
2. In General settings, view number information (country, number type, capability, ownership type, number ID, monthly fee) and optionally connect an application and entity for invoicing and reporting.
3. Select the channel tabs available for your number (SMS, WhatsApp, Voice, MMS, and more) to configure inbound routing and view channel-specific details.
4. Select Save.

Configure inbound routing [#configure-inbound-routing-manage-numbers]

Inbound routing controls how messages received on your number are processed. It uses a two-layer approach:

• A default action handles all messages that do not match a keyword
• Keywords override the default for specific message patterns

If neither applies, active subscriptions and other routing settings determine the outcome. All messages are saved in logs regardless of routing.

Available actions [#available-actions-manage-numbers]

Choose one or more actions to determine how inbound messages are processed:

Set up inbound routing [#set-up-inbound-routing-manage-numbers]

Go to Channels and numbers > Numbers > My numbers, select your number, open its details page, select the SMS tab, and go to Inbound configuration.

Set a default action to handle messages that do not match a keyword:

• Forwarding action (choose at most one): Apply Subscriptions, Forward to HTTP, Forward to Email, Pull, or Forward to SMPP
• Non-forwarding actions (add multiple): Conversations, Auto response, Blocking action

Configure keywords to route specific messages to specific actions:

1. In Inbound configuration, select Add keyword.
2. Enter the Keyword (any length, case-insensitive).
3. Select the Action and configure its details (webhook URL, email, and more).
4. Optionally set Username and Application and entities for tracking and reporting.
5. Select Save keyword and repeat for additional keywords.

Keyword routing examples:

• Keyword PROMO → Forward to HTTP → https://promo-system.com/webhook
• Keyword SUPPORT → Forward to Email → support@company.com
• Keyword SURVEY → Conversations
• Default (no keyword match) → Pull

Bulk operations

Manage multiple numbers at once:

1. In My numbers, select multiple numbers using checkboxes.
2. Use the bulk action menu to update shared settings, cancel multiple numbers, or export the number list.
3. Confirm the bulk action and view the operation status.

Cancel numbers

Stop using a number and remove it from your account:

1. Select the number from My numbers.
2. Open Number details and go to the end of the page.
3. Select Cancel number and confirm.
4. The number transitions to "Inactive" status. Billing stops at the next billing cycle.

Manage through API

Automate number management using the Resource Management API.

Use the API to:

• Retrieve resource information: List details about numbers, sender IDs, and other resources.
• Manage inbound configurations: Set up default actions, keywords, and routing for inbound messages.
• Manage numbers: Cancel or update number configuration and settings.
• Check coverage: Verify channel capabilities and network availability by country.