Skip to content

RequestPhoneNumberRequest

Source code in docs_src/capo_pinpoint_sms_voice_v2/types/request_phone_number_request.py
class RequestPhoneNumberRequest(TypedDict, closed=True):
    iso_country_code: "capo_pinpoint_sms_voice_v2.types.iso_country_code.IsoCountryCode"
    """<p>The two-character code, in ISO 3166-1 alpha-2 format, for the country or region. </p>"""
    message_type: "capo_pinpoint_sms_voice_v2.types.message_type.MessageType"
    """<p>The type of message. Valid values are <code>TRANSACTIONAL</code> for messages that are critical or time-sensitive and <code>PROMOTIONAL</code> for messages that aren't critical or time-sensitive.</p>"""
    number_capabilities: (
        "capo_pinpoint_sms_voice_v2.types.number_capability_list.NumberCapabilityList"
    )
    """<p>Indicates if the phone number will be used for text messages, voice messages, or both. </p>"""
    number_type: (
        "capo_pinpoint_sms_voice_v2.types.requestable_number_type.RequestableNumberType"
    )
    """<p>The type of phone number to request.</p> <p>When you request a <code>SIMULATOR</code> phone number, you must set <b>MessageType</b> as <code>TRANSACTIONAL</code>. </p>"""
    opt_out_list_name: NotRequired[
        "capo_pinpoint_sms_voice_v2.types.opt_out_list_name_or_arn.OptOutListNameOrArn"
    ]
    """<p>The name of the OptOutList to associate with the phone number. You can use the OptOutListName or OptOutListArn.</p> <important> <p>If you are using a shared End User Messaging SMS resource then you must use the full Amazon Resource Name(ARN).</p> </important>"""
    pool_id: NotRequired["capo_pinpoint_sms_voice_v2.types.pool_id_or_arn.PoolIdOrArn"]
    """<p>The pool to associated with the phone number. You can use the PoolId or PoolArn. </p> <important> <p>If you are using a shared End User Messaging SMS resource then you must use the full Amazon Resource Name(ARN).</p> </important>"""
    registration_id: NotRequired[
        "capo_pinpoint_sms_voice_v2.types.registration_id_or_arn.RegistrationIdOrArn"
    ]
    """<p>Use this field to attach your phone number for an external registration process.</p>"""
    number_preference: NotRequired[
        "capo_pinpoint_sms_voice_v2.types.number_preference_list.NumberPreferenceList"
    ]
    """<p>An optional selection preference used to request a specific phone number, such as a number that starts with, ends with, or contains a particular digit pattern. You can specify at most one preference. Number preferences apply only to <code>TEN_DLC</code> requests in the <code>US</code>.</p>"""
    international_sending_enabled: NotRequired["bool"]
    """<p>By default this is set to false. When set to true the international sending of phone number is Enabled. </p>"""
    deletion_protection_enabled: NotRequired["bool"]
    """<p>By default this is set to false. When set to true the phone number can't be deleted.</p>"""
    tags: NotRequired["capo_pinpoint_sms_voice_v2.types.tag_list.TagList"]
    """<p>An array of tags (key and value pairs) to associate with the requested phone number. </p>"""
    client_token: NotRequired[
        "capo_pinpoint_sms_voice_v2.types.client_token.ClientToken"
    ]
    """<p>Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you don't specify a client token, a randomly generated token is used for the request to ensure idempotency.</p>"""

client_token instance-attribute

client_token: NotRequired[ClientToken]

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you don't specify a client token, a randomly generated token is used for the request to ensure idempotency.

deletion_protection_enabled instance-attribute

deletion_protection_enabled: NotRequired[bool]

By default this is set to false. When set to true the phone number can't be deleted.

international_sending_enabled instance-attribute

international_sending_enabled: NotRequired[bool]

By default this is set to false. When set to true the international sending of phone number is Enabled.

iso_country_code instance-attribute

iso_country_code: IsoCountryCode

The two-character code, in ISO 3166-1 alpha-2 format, for the country or region.

message_type instance-attribute

message_type: MessageType

The type of message. Valid values are TRANSACTIONAL for messages that are critical or time-sensitive and PROMOTIONAL for messages that aren't critical or time-sensitive.

number_capabilities instance-attribute

number_capabilities: NumberCapabilityList

Indicates if the phone number will be used for text messages, voice messages, or both.

number_preference instance-attribute

number_preference: NotRequired[NumberPreferenceList]

An optional selection preference used to request a specific phone number, such as a number that starts with, ends with, or contains a particular digit pattern. You can specify at most one preference. Number preferences apply only to TEN_DLC requests in the US.

number_type instance-attribute

number_type: RequestableNumberType

The type of phone number to request.

When you request a SIMULATOR phone number, you must set MessageType as TRANSACTIONAL.

opt_out_list_name instance-attribute

opt_out_list_name: NotRequired[OptOutListNameOrArn]

The name of the OptOutList to associate with the phone number. You can use the OptOutListName or OptOutListArn.

If you are using a shared End User Messaging SMS resource then you must use the full Amazon Resource Name(ARN).

pool_id instance-attribute

pool_id: NotRequired[PoolIdOrArn]

The pool to associated with the phone number. You can use the PoolId or PoolArn.

If you are using a shared End User Messaging SMS resource then you must use the full Amazon Resource Name(ARN).

registration_id instance-attribute

registration_id: NotRequired[RegistrationIdOrArn]

Use this field to attach your phone number for an external registration process.

tags instance-attribute

tags: NotRequired[TagList]

An array of tags (key and value pairs) to associate with the requested phone number.