Create a phone number override rule in AWS End User Messaging SMS - AWS End User Messaging SMS
This documentation is a draft for private preview for regions in the AWS European Sovereign Cloud. Documentation content will continue to evolve. Published: January 14, 2026.

Create a phone number override rule in AWS End User Messaging SMS

To create a new phone number override rule, you can use the AWS End User Messaging SMS console, the PutProtectConfigurationRuleSetNumberOverride action in the AWS End User Messaging SMS and voice v2 API, or the put-protect-configuration-rule-set-number-override command in the AWS CLI. This section shows how to create a phone number override rule using the AWS End User Messaging SMS console and the AWS CLI.

Create a phone number rule override (Console)

To create a phone number override rule using the AWS End User Messaging SMS console, follow these steps:

  1. Open the AWS End User Messaging SMS console at https://console.aws.amazon.com/sms-voice/.

  2. In the navigation pane, under Protect, choose Protect configuration and then choose the protect configuration to add a new phone number override rule to.

  3. Choose the Rule overrides tab and in the Rules override section choose Add override.

  4. In the Rule override details section, enter the following:

    1. For Destination phone number enter the phone number to create the rule for. The phone number must start with a '+' and can't contain any spaces, hyphens, or parentheses. For example, +1 (206) 555-0142 is not in the correct format, but +12065550142 is.

    2. For Override type choose either Always allow or Always block.

    3. For Expiration date – optional choose a date for the rule expire or leave it blank for the rule to never expire.

  5. Choose Add rule override.

Create a phone number rule override (AWS CLI)

You can use the put-protect-configuration-rule-set-number-override AWS CLI command to create a new phone number rule override.

Note

Because --expiration-timestamp is not specified this rule will never expire.

$ aws pinpoint-sms-voice-v2 put-protect-configuration-rule-set-number-override --protect-configuration-id ProtectConfigurationID --destination-phone-number +12065550150 --action ACTION

In the preceding command, make the following changes:

  • Replace ProtectConfigurationID with the unique identifier of the protect configuration.

  • Replace +12065550150 with the phone number to create a rule for.

  • Replace ACTION with ALLOW to allow messages to be sent to the phone number or BLOCK to not allow messages to the phone number.