Releasing a phone number from your Amazon Pinpoint SMS account.

If you don't need a phone number that you had previously requested through Amazon Pinpoint SMS anymore, you can release it from your Amazon Pinpoint SMS account. When you release a number, AWS stops charging you for it in your bill for the next calendar month.

Important

Releasing a phone number from your Amazon Pinpoint SMS account is permanent and can't be undone. If you release a phone number, you won't be able to obtain the same number again in the future.

Deletion protection has to be disabled before you can release a phone number. For more information on deletion protection, see Deletion protection.

Release a phone number from your Amazon Pinpoint SMS account (Console)

To release a phone number from your Amazon Pinpoint SMS account using the Amazon Pinpoint SMS console, follow these steps:

Release a phone number (Console)

1. Open the Amazon Pinpoint SMS console at https://console.aws.amazon.com/sms-voice/.

2. In the navigation pane, under Configurations, choose Phone numbers.

3. Choose the phone number that you want to release and then choose Release phone number.

4. On the Release phone number window enter release and choose Release phone number.

Release a phone number from your Amazon Pinpoint SMS account (AWS CLI)

You can use the release-phone-number CLI to release phone numbers from your account.

$ aws pinpoint-sms-voice-v2 release-phone-number \
> --phone-number-id phoneNumberId
                

In the preceding command, replace phoneNumberId with the unique ID or Amazon Resource Name (ARN) of the phone number.