View Source AWS.PinpointSMSVoiceV2 (aws-elixir v0.14.1)

Welcome to the Amazon Pinpoint SMS and Voice, version 2 API Reference.

This guide provides information about Amazon Pinpoint SMS and Voice, version 2 API resources, including supported HTTP methods, parameters, and schemas.

Amazon Pinpoint is an Amazon Web Services service that you can use to engage with your recipients across multiple messaging channels. The Amazon Pinpoint SMS and Voice, version 2 API provides programmatic access to options that are unique to the SMS and voice channels and supplements the resources provided by the Amazon Pinpoint API.

If you're new to Amazon Pinpoint, it's also helpful to review the Amazon Pinpoint Developer Guide. The Amazon Pinpoint Developer Guide provides tutorials, code samples, and procedures that demonstrate how to use Amazon Pinpoint features programmatically and how to integrate Amazon Pinpoint functionality into mobile apps and other types of applications. The guide also provides key information, such as Amazon Pinpoint integration with other Amazon Web Services services, and the quotas that apply to use of the service.

Regional availability

The Amazon Pinpoint SMS and Voice, version 2 API Reference is available in several Amazon Web Services Regions and it provides an endpoint for each of these Regions. For a list of all the Regions and endpoints where the API is currently available, see Amazon Web Services Service Endpoints and Amazon Pinpoint endpoints and quotas in the Amazon Web Services General Reference. To learn more about Amazon Web Services Regions, see Managing Amazon Web Services Regions in the Amazon Web Services General Reference.

In each Region, Amazon Web Services maintains multiple Availability Zones. These Availability Zones are physically isolated from each other, but are united by private, low-latency, high-throughput, and highly redundant network connections. These Availability Zones enable us to provide very high levels of availability and redundancy, while also minimizing latency. To learn more about the number of Availability Zones that are available in each Region, see Amazon Web Services Global Infrastructure.

Summary

Functions

Associates the specified origination identity with a pool.

Creates a new event destination in a configuration set.

Creates a new pool and associates the specified origination identity to the pool.

Creates a new registration based on the RegistrationType field.

Associate the registration with an origination identity such as a phone number or sender ID.

Create a new registration attachment to use for uploading a file or a URL to a file.

Create a new version of the registration and increase the VersionNumber.

You can only send messages to verified destination numbers when your account is in the sandbox.

Deletes an existing configuration set.

Deletes an existing default message type on a configuration set.

Deletes an existing default sender ID on a configuration set.

Deletes an existing event destination.

Deletes an existing keyword from an origination phone number or pool.

Deletes an existing opt-out list.

Deletes an existing opted out destination phone number from the specified opt-out list.

Deletes an existing pool.

Permanently delete an existing registration from your account.

Permanently delete the specified registration attachment.

Delete the value in a registration form field.

Deletes an account-level monthly spending limit override for sending text messages.

Delete a verified destination phone number.

Deletes an account level monthly spend limit override for sending voice messages.

Describes attributes of your Amazon Web Services account.

Describes the current Amazon Pinpoint SMS Voice V2 resource quotas for your account.

Describes the specified configuration sets or all in your account.

Describes the specified keywords or all keywords on your origination phone number or pool.

Describes the specified opt-out list or all opt-out lists in your account.

Describes the specified opted out destination numbers or all opted out destination numbers in an opt-out list.

Describes the specified origination phone number, or all the phone numbers in your account.

Retrieves the specified pools or all pools associated with your Amazon Web Services account.

Retrieves the specified registration attachments or all registration attachments associated with your Amazon Web Services account.

Retrieves the specified registration type field definitions.

Retrieves the specified registration field values.

Retrieves the specified registration section definitions.

Retrieves the specified registration type definitions.

Retrieves the specified registration version.

Retrieves the specified registrations.

Describes the specified SenderIds or all SenderIds associated with your Amazon Web Services account.

Describes the current Amazon Pinpoint monthly spend limits for sending voice and text messages.

Retrieves the specified verified destiona numbers.

Removes the specified origination identity from an existing pool.

Discard the current version of the registration.

Lists all associated origination identities in your pool.

Retreive all of the origination identies that are associated with a registration.

List all tags associated with a resource.

Creates or updates a keyword configuration on an origination phone number or pool.

Creates an opted out destination phone number in the opt-out list.

Creates or updates a field value for a registration.

Releases an existing origination phone number in your account.

Releases an existing sender ID in your account.

Request an origination phone number for use in your account.

Request a new sender ID that doesn't require registration.

Before you can send test messages to a verified destination phone number you need to opt-in the verified destination phone number.

Creates a new text message and sends it to a recipient's phone number.

Allows you to send a request that sends a voice message through Amazon Pinpoint.

Sets the default message type on a configuration set.

Sets default sender ID on a configuration set.

Sets an account level monthly spend limit override for sending text messages.

Sets an account level monthly spend limit override for sending voice messages.

Submit the specified registration for review and approval.

Adds or overwrites only the specified tags for the specified Amazon Pinpoint SMS Voice, version 2 resource.

Removes the association of the specified tags from an Amazon Pinpoint SMS Voice V2 resource.

Updates an existing event destination in a configuration set.

Updates the configuration of an existing origination phone number.

Updates the configuration of an existing pool.

Updates the configuration of an existing sender ID.

Use the verification code that was received by the verified destination phone number to opt-in the verified destination phone number to receive more messages.

Functions

Link to this function

associate_origination_identity(client, input, options \\ [])

View Source

Associates the specified origination identity with a pool.

If the origination identity is a phone number and is already associated with another pool, an error is returned. A sender ID can be associated with multiple pools.

If the origination identity configuration doesn't match the pool's configuration, an error is returned.

Link to this function

create_configuration_set(client, input, options \\ [])

View Source

Creates a new configuration set.

After you create the configuration set, you can add one or more event destinations to it.

A configuration set is a set of rules that you apply to the SMS and voice messages that you send.

When you send a message, you can optionally specify a single configuration set.

Link to this function

create_event_destination(client, input, options \\ [])

View Source

Creates a new event destination in a configuration set.

An event destination is a location where you send message events. The event options are Amazon CloudWatch, Amazon Kinesis Data Firehose, or Amazon SNS. For example, when a message is delivered successfully, you can send information about that event to an event destination, or send notifications to endpoints that are subscribed to an Amazon SNS topic.

Each configuration set can contain between 0 and 5 event destinations. Each event destination can contain a reference to a single destination, such as a CloudWatch or Kinesis Data Firehose destination.

Link to this function

create_opt_out_list(client, input, options \\ [])

View Source

Creates a new opt-out list.

If the opt-out list name already exists, an error is returned.

An opt-out list is a list of phone numbers that are opted out, meaning you can't send SMS or voice messages to them. If end user replies with the keyword "STOP," an entry for the phone number is added to the opt-out list. In addition to STOP, your recipients can use any supported opt-out keyword, such as CANCEL or OPTOUT. For a list of supported opt-out keywords, see SMS opt out in the Amazon Pinpoint User Guide.

Link to this function

create_pool(client, input, options \\ [])

View Source

Creates a new pool and associates the specified origination identity to the pool.

A pool can include one or more phone numbers and SenderIds that are associated with your Amazon Web Services account.

The new pool inherits its configuration from the specified origination identity. This includes keywords, message type, opt-out list, two-way configuration, and self-managed opt-out configuration. Deletion protection isn't inherited from the origination identity and defaults to false.

If the origination identity is a phone number and is already associated with another pool, an error is returned. A sender ID can be associated with multiple pools.

Link to this function

create_registration(client, input, options \\ [])

View Source

Creates a new registration based on the RegistrationType field.

Link to this function

create_registration_association(client, input, options \\ [])

View Source

Associate the registration with an origination identity such as a phone number or sender ID.

Link to this function

create_registration_attachment(client, input, options \\ [])

View Source

Create a new registration attachment to use for uploading a file or a URL to a file.

The maximum file size is 1MiB and valid file extensions are PDF, JPEG and PNG. For example, many sender ID registrations require a signed “letter of authorization” (LOA) to be submitted.

Link to this function

create_registration_version(client, input, options \\ [])

View Source

Create a new version of the registration and increase the VersionNumber.

The previous version of the registration becomes read-only.

Link to this function

create_verified_destination_number(client, input, options \\ [])

View Source

You can only send messages to verified destination numbers when your account is in the sandbox.

You can add up to 10 verified destination numbers.

Link to this function

delete_configuration_set(client, input, options \\ [])

View Source

Deletes an existing configuration set.

A configuration set is a set of rules that you apply to voice and SMS messages that you send. In a configuration set, you can specify a destination for specific types of events related to voice and SMS messages.

Link to this function

delete_default_message_type(client, input, options \\ [])

View Source

Deletes an existing default message type on a configuration set.

A message type is a type of messages that you plan to send. If you send account-related messages or time-sensitive messages such as one-time passcodes, choose Transactional. If you plan to send messages that contain marketing material or other promotional content, choose Promotional. This setting applies to your entire Amazon Web Services account.

Link to this function

delete_default_sender_id(client, input, options \\ [])

View Source

Deletes an existing default sender ID on a configuration set.

A default sender ID is the identity that appears on recipients' devices when they receive SMS messages. Support for sender ID capabilities varies by country or region.

Link to this function

delete_event_destination(client, input, options \\ [])

View Source

Deletes an existing event destination.

An event destination is a location where you send response information about the messages that you send. For example, when a message is delivered successfully, you can send information about that event to an Amazon CloudWatch destination, or send notifications to endpoints that are subscribed to an Amazon SNS topic.

Link to this function

delete_keyword(client, input, options \\ [])

View Source

Deletes an existing keyword from an origination phone number or pool.

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, Amazon Pinpoint responds with a customizable message.

Keywords "HELP" and "STOP" can't be deleted or modified.

Link to this function

delete_opt_out_list(client, input, options \\ [])

View Source

Deletes an existing opt-out list.

All opted out phone numbers in the opt-out list are deleted.

If the specified opt-out list name doesn't exist or is in-use by an origination phone number or pool, an error is returned.

Link to this function

delete_opted_out_number(client, input, options \\ [])

View Source

Deletes an existing opted out destination phone number from the specified opt-out list.

Each destination phone number can only be deleted once every 30 days.

If the specified destination phone number doesn't exist or if the opt-out list doesn't exist, an error is returned.

Link to this function

delete_pool(client, input, options \\ [])

View Source

Deletes an existing pool.

Deleting a pool disassociates all origination identities from that pool.

If the pool status isn't active or if deletion protection is enabled, an error is returned.

A pool is a collection of phone numbers and SenderIds. A pool can include one or more phone numbers and SenderIds that are associated with your Amazon Web Services account.

Link to this function

delete_registration(client, input, options \\ [])

View Source

Permanently delete an existing registration from your account.

Link to this function

delete_registration_attachment(client, input, options \\ [])

View Source

Permanently delete the specified registration attachment.

Link to this function

delete_registration_field_value(client, input, options \\ [])

View Source

Delete the value in a registration form field.

Link to this function

delete_text_message_spend_limit_override(client, input, options \\ [])

View Source

Deletes an account-level monthly spending limit override for sending text messages.

Deleting a spend limit override will set the EnforcedLimit to equal the MaxLimit, which is controlled by Amazon Web Services. For more information on spend limits (quotas) see Amazon Pinpoint quotas in the Amazon Pinpoint Developer Guide.

Link to this function

delete_verified_destination_number(client, input, options \\ [])

View Source

Delete a verified destination phone number.

Link to this function

delete_voice_message_spend_limit_override(client, input, options \\ [])

View Source

Deletes an account level monthly spend limit override for sending voice messages.

Deleting a spend limit override sets the EnforcedLimit equal to the MaxLimit, which is controlled by Amazon Web Services. For more information on spending limits (quotas) see Amazon Pinpoint quotas in the Amazon Pinpoint Developer Guide.

Link to this function

describe_account_attributes(client, input, options \\ [])

View Source

Describes attributes of your Amazon Web Services account.

The supported account attributes include account tier, which indicates whether your account is in the sandbox or production environment. When you're ready to move your account out of the sandbox, create an Amazon Web Services Support case for a service limit increase request.

New Amazon Pinpoint accounts are placed into an SMS or voice sandbox. The sandbox protects both Amazon Web Services end recipients and SMS or voice recipients from fraud and abuse.

Link to this function

describe_account_limits(client, input, options \\ [])

View Source

Describes the current Amazon Pinpoint SMS Voice V2 resource quotas for your account.

The description for a quota includes the quota name, current usage toward that quota, and the quota's maximum value.

When you establish an Amazon Web Services account, the account has initial quotas on the maximum number of configuration sets, opt-out lists, phone numbers, and pools that you can create in a given Region. For more information see Amazon Pinpoint quotas in the Amazon Pinpoint Developer Guide.

Link to this function

describe_configuration_sets(client, input, options \\ [])

View Source

Describes the specified configuration sets or all in your account.

If you specify configuration set names, the output includes information for only the specified configuration sets. If you specify filters, the output includes information for only those configuration sets that meet the filter criteria. If you don't specify configuration set names or filters, the output includes information for all configuration sets.

If you specify a configuration set name that isn't valid, an error is returned.

Link to this function

describe_keywords(client, input, options \\ [])

View Source

Describes the specified keywords or all keywords on your origination phone number or pool.

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, Amazon Pinpoint responds with a customizable message.

If you specify a keyword that isn't valid, an error is returned.

Link to this function

describe_opt_out_lists(client, input, options \\ [])

View Source

Describes the specified opt-out list or all opt-out lists in your account.

If you specify opt-out list names, the output includes information for only the specified opt-out lists. Opt-out lists include only those that meet the filter criteria. If you don't specify opt-out list names or filters, the output includes information for all opt-out lists.

If you specify an opt-out list name that isn't valid, an error is returned.

Link to this function

describe_opted_out_numbers(client, input, options \\ [])

View Source

Describes the specified opted out destination numbers or all opted out destination numbers in an opt-out list.

If you specify opted out numbers, the output includes information for only the specified opted out numbers. If you specify filters, the output includes information for only those opted out numbers that meet the filter criteria. If you don't specify opted out numbers or filters, the output includes information for all opted out destination numbers in your opt-out list.

If you specify an opted out number that isn't valid, an error is returned.

Link to this function

describe_phone_numbers(client, input, options \\ [])

View Source

Describes the specified origination phone number, or all the phone numbers in your account.

If you specify phone number IDs, the output includes information for only the specified phone numbers. If you specify filters, the output includes information for only those phone numbers that meet the filter criteria. If you don't specify phone number IDs or filters, the output includes information for all phone numbers.

If you specify a phone number ID that isn't valid, an error is returned.

Link to this function

describe_pools(client, input, options \\ [])

View Source

Retrieves the specified pools or all pools associated with your Amazon Web Services account.

If you specify pool IDs, the output includes information for only the specified pools. If you specify filters, the output includes information for only those pools that meet the filter criteria. If you don't specify pool IDs or filters, the output includes information for all pools.

If you specify a pool ID that isn't valid, an error is returned.

A pool is a collection of phone numbers and SenderIds. A pool can include one or more phone numbers and SenderIds that are associated with your Amazon Web Services account.

Link to this function

describe_registration_attachments(client, input, options \\ [])

View Source

Retrieves the specified registration attachments or all registration attachments associated with your Amazon Web Services account.

Link to this function

describe_registration_field_definitions(client, input, options \\ [])

View Source

Retrieves the specified registration type field definitions.

You can use DescribeRegistrationFieldDefinitions to view the requirements for creating, filling out, and submitting each registration type.

Link to this function

describe_registration_field_values(client, input, options \\ [])

View Source

Retrieves the specified registration field values.

Link to this function

describe_registration_section_definitions(client, input, options \\ [])

View Source

Retrieves the specified registration section definitions.

You can use DescribeRegistrationSectionDefinitions to view the requirements for creating, filling out, and submitting each registration type.

Link to this function

describe_registration_type_definitions(client, input, options \\ [])

View Source

Retrieves the specified registration type definitions.

You can use DescribeRegistrationTypeDefinitions to view the requirements for creating, filling out, and submitting each registration type.

Link to this function

describe_registration_versions(client, input, options \\ [])

View Source

Retrieves the specified registration version.

Link to this function

describe_registrations(client, input, options \\ [])

View Source

Retrieves the specified registrations.

Link to this function

describe_sender_ids(client, input, options \\ [])

View Source

Describes the specified SenderIds or all SenderIds associated with your Amazon Web Services account.

If you specify SenderIds, the output includes information for only the specified SenderIds. If you specify filters, the output includes information for only those SenderIds that meet the filter criteria. If you don't specify SenderIds or filters, the output includes information for all SenderIds.

f you specify a sender ID that isn't valid, an error is returned.

Link to this function

describe_spend_limits(client, input, options \\ [])

View Source

Describes the current Amazon Pinpoint monthly spend limits for sending voice and text messages.

When you establish an Amazon Web Services account, the account has initial monthly spend limit in a given Region. For more information on increasing your monthly spend limit, see Requesting increases to your monthly SMS spending quota for Amazon Pinpoint in the Amazon Pinpoint User Guide.

Link to this function

describe_verified_destination_numbers(client, input, options \\ [])

View Source

Retrieves the specified verified destiona numbers.

Link to this function

disassociate_origination_identity(client, input, options \\ [])

View Source

Removes the specified origination identity from an existing pool.

If the origination identity isn't associated with the specified pool, an error is returned.

Link to this function

discard_registration_version(client, input, options \\ [])

View Source

Discard the current version of the registration.

Link to this function

list_pool_origination_identities(client, input, options \\ [])

View Source

Lists all associated origination identities in your pool.

If you specify filters, the output includes information for only those origination identities that meet the filter criteria.

Link to this function

list_registration_associations(client, input, options \\ [])

View Source

Retreive all of the origination identies that are associated with a registration.

Link to this function

list_tags_for_resource(client, input, options \\ [])

View Source

List all tags associated with a resource.

Link to this function

put_keyword(client, input, options \\ [])

View Source

Creates or updates a keyword configuration on an origination phone number or pool.

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, Amazon Pinpoint responds with a customizable message.

If you specify a keyword that isn't valid, an error is returned.

Link to this function

put_opted_out_number(client, input, options \\ [])

View Source

Creates an opted out destination phone number in the opt-out list.

If the destination phone number isn't valid or if the specified opt-out list doesn't exist, an error is returned.

Link to this function

put_registration_field_value(client, input, options \\ [])

View Source

Creates or updates a field value for a registration.

Link to this function

release_phone_number(client, input, options \\ [])

View Source

Releases an existing origination phone number in your account.

Once released, a phone number is no longer available for sending messages.

If the origination phone number has deletion protection enabled or is associated with a pool, an error is returned.

Link to this function

release_sender_id(client, input, options \\ [])

View Source

Releases an existing sender ID in your account.

Link to this function

request_phone_number(client, input, options \\ [])

View Source

Request an origination phone number for use in your account.

For more information on phone number request see Requesting a number in the Amazon Pinpoint User Guide.

Link to this function

request_sender_id(client, input, options \\ [])

View Source

Request a new sender ID that doesn't require registration.

Link to this function

send_destination_number_verification_code(client, input, options \\ [])

View Source

Before you can send test messages to a verified destination phone number you need to opt-in the verified destination phone number.

Creates a new text message with a verification code and send it to a verified destination phone number. Once you have the verification code use VerifyDestinationNumber to opt-in the verified destination phone number to receive messages.

Link to this function

send_text_message(client, input, options \\ [])

View Source

Creates a new text message and sends it to a recipient's phone number.

SMS throughput limits are measured in Message Parts per Second (MPS). Your MPS limit depends on the destination country of your messages, as well as the type of phone number (origination number) that you use to send the message. For more information, see Message Parts per Second (MPS) limits in the Amazon Pinpoint User Guide.

Link to this function

send_voice_message(client, input, options \\ [])

View Source

Allows you to send a request that sends a voice message through Amazon Pinpoint.

This operation uses Amazon Polly to convert a text script into a voice message.

Link to this function

set_default_message_type(client, input, options \\ [])

View Source

Sets the default message type on a configuration set.

Choose the category of SMS messages that you plan to send from this account. If you send account-related messages or time-sensitive messages such as one-time passcodes, choose Transactional. If you plan to send messages that contain marketing material or other promotional content, choose Promotional. This setting applies to your entire Amazon Web Services account.

Link to this function

set_default_sender_id(client, input, options \\ [])

View Source

Sets default sender ID on a configuration set.

When sending a text message to a destination country that supports sender IDs, the default sender ID on the configuration set specified will be used if no dedicated origination phone numbers or registered sender IDs are available in your account.

Link to this function

set_text_message_spend_limit_override(client, input, options \\ [])

View Source

Sets an account level monthly spend limit override for sending text messages.

The requested spend limit must be less than or equal to the MaxLimit, which is set by Amazon Web Services.

Link to this function

set_voice_message_spend_limit_override(client, input, options \\ [])

View Source

Sets an account level monthly spend limit override for sending voice messages.

The requested spend limit must be less than or equal to the MaxLimit, which is set by Amazon Web Services.

Link to this function

submit_registration_version(client, input, options \\ [])

View Source

Submit the specified registration for review and approval.

Link to this function

tag_resource(client, input, options \\ [])

View Source

Adds or overwrites only the specified tags for the specified Amazon Pinpoint SMS Voice, version 2 resource.

When you specify an existing tag key, the value is overwritten with the new value. Each resource can have a maximum of 50 tags. Each tag consists of a key and an optional value. Tag keys must be unique per resource. For more information about tags, see Tagging Amazon Pinpoint resources in the Amazon Pinpoint Developer Guide.

Link to this function

untag_resource(client, input, options \\ [])

View Source

Removes the association of the specified tags from an Amazon Pinpoint SMS Voice V2 resource.

For more information on tags see Tagging Amazon Pinpoint resources in the Amazon Pinpoint Developer Guide.

Link to this function

update_event_destination(client, input, options \\ [])

View Source

Updates an existing event destination in a configuration set.

You can update the IAM role ARN for CloudWatch Logs and Kinesis Data Firehose. You can also enable or disable the event destination.

You may want to update an event destination to change its matching event types or updating the destination resource ARN. You can't change an event destination's type between CloudWatch Logs, Kinesis Data Firehose, and Amazon SNS.

Link to this function

update_phone_number(client, input, options \\ [])

View Source

Updates the configuration of an existing origination phone number.

You can update the opt-out list, enable or disable two-way messaging, change the TwoWayChannelArn, enable or disable self-managed opt-outs, and enable or disable deletion protection.

If the origination phone number is associated with a pool, an error is returned.

Link to this function

update_pool(client, input, options \\ [])

View Source

Updates the configuration of an existing pool.

You can update the opt-out list, enable or disable two-way messaging, change the TwoWayChannelArn, enable or disable self-managed opt-outs, enable or disable deletion protection, and enable or disable shared routes.

Link to this function

update_sender_id(client, input, options \\ [])

View Source

Updates the configuration of an existing sender ID.

Link to this function

verify_destination_number(client, input, options \\ [])

View Source

Use the verification code that was received by the verified destination phone number to opt-in the verified destination phone number to receive more messages.