---
type: resource-type
title: SMSVOICEPhoneNumber
description: aws resource type AWS::SMSVOICE::PhoneNumber
name: SMSVOICEPhoneNumber
lexicon: aws
resource_type: AWS::SMSVOICE::PhoneNumber
---
`AWS::SMSVOICE::PhoneNumber`, a resource type of the aws lexicon.

## Properties

- `IsoCountryCode` (`string`, required): The two-character code, in ISO 3166-1 alpha-2 format, for the country or region.
- `MandatoryKeywords` (`Record<string, unknown>`, required): A keyword is a word that you can search for on a particular phone number or pool. It is also a specific word or phrase that an end user can send to your number to elicit a response, such as an informational message or a special offer. When your number receives a message that begins with a keyword, AWS End User Messaging SMS and Voice responds with a customizable message. Keywords "HELP" and "STOP" are mandatory keywords
- `NumberCapabilities` (`"MMS" | "SMS" | "VOICE"[]`, required): Indicates if the phone number will be used for text messages, voice messages, or both.
- `NumberType` (`"LONG_CODE" | "SIMULATOR" | "TEN_DLC" | "TOLL_FREE"`, required): The type of phone number to request.
- `Arn` (`string`, optional)
- `DeletionProtectionEnabled` (`boolean`, optional): When set to true the sender ID can't be deleted. By default this is set to false.
- `OptionalKeywords` (`SMSVOICEPhoneNumber_OptionalKeyword[]`, optional): A keyword is a word that you can search for on a particular phone number or pool. It is also a specific word or phrase that an end user can send to your number to elicit a response, such as an informational message or a special offer. When your number receives a message that begins with a keyword, AWS End User Messaging SMS and Voice responds with a customizable message.
- `OptOutListName` (`string`, optional): The name of the OptOutList to associate with the phone number. You can use the OptOutListName or OptOutListArn.
- `PhoneNumber` (`string`, optional)
- `PhoneNumberId` (`string`, optional)
- `SelfManagedOptOutsEnabled` (`boolean`, optional): By default this is set to false. When an end recipient sends a message that begins with HELP or STOP to one of your dedicated numbers, AWS End User Messaging SMS and Voice automatically replies with a customizable message and adds the end recipient to the OptOutList. When set to true you're responsible for responding to HELP and STOP requests. You're also responsible for tracking and honoring opt-out requests.
- `Tags` (`SMSVOICEPhoneNumber_Tag[]`, optional): An array of key-value pairs to apply to this resource.
- `TwoWay` (`Record<string, unknown>`, optional): When you set up two-way SMS, you can receive incoming messages from your customers. When one of your customers sends a message to your phone number, the message body is sent to an Amazon SNS topic or Amazon Connect for processing.

## Attributes

- `Arn`
- `PhoneNumber`
- `PhoneNumberId`