Creating a project and enabling the Amazon Pinpoint SMS channel - Amazon Pinpoint

Creating a project and enabling the Amazon Pinpoint SMS channel

To send SMS messages with Amazon Pinpoint, you need an Amazon Pinpoint project in which the SMS channel is enabled. If you have an existing project in Amazon Pinpoint you'll need to first enable it for SMS.

Creating a new project using the Amazon Pinpoint console

The first step in setting up the SMS channel in Amazon Pinpoint is to create a new project and enable SMS for that project.

To create a new Amazon Pinpoint project and enable the SMS channel

  1. Open the Amazon Pinpoint console at https://console.aws.amazon.com/pinpoint/.

  2. On the All projects page, choose Create a project.

  3. For Project name, enter a name, and then choose Create.

    Note

    The project name can contain up to 64 alphanumeric characters. It can also include the following characters: comma (,), period (.), at sign (@), underscore (_), equals sign (=), and plus sign (+).

  4. Under Project features, in the SMS and voice section, choose Configure.

  5. Choose Enable the SMS channel for this project.

  6. Under Account-level settings, you can optionally change the following settings:

    • Default message type – The category of messages that you plan to send. Choose Transactional for time-sensitive content, such as alerts and one-time passwords, or choose Promotional for marketing-related content.

    • Account spending limit – The maximum amount of money, in US Dollars, that you want to spend sending SMS messages per calendar month. If your monthly spending exceeds this value, Amazon Pinpoint and other AWS services stop sending SMS messages from your account.

      Note

      If you haven't used Amazon Pinpoint or Amazon SNS to send SMS messages from your AWS account, your account will have a default spending quota of $1.00 (USD). You can request an increase to this account-wide quota. For more information, see Requesting increases to your monthly SMS spending quota for Amazon Pinpoint.

    • Default sender ID – The identity that appears on recipients' devices when they receive messages. Support for sender ID capabilities varies by country or region.

    Important

    These settings apply to your entire AWS account. When you change these settings, they apply to all other Amazon Pinpoint projects in your account, and to other AWS services that you use to send SMS messages, such as Amazon SNS.

  7. When you finish, choose Save changes.

Enabling the Amazon Pinpoint SMS channel for an existing project

Before you can use Amazon Pinpoint to send SMS messages, you must enable the SMS channel for one or more projects using the Amazon Pinpoint console. If you've already created a project but not yet enabled SMS, you'll first need to do this. When enabling SMS for a project you can also manage the SMS and channel settings, such as your default message type (transactional or promotional) and your monthly spending quota. For more information, see Managing SMS and voice settings.

To enable the SMS channel for a project

  1. Sign in to the AWS Management Console and open the Amazon Pinpoint console at https://console.aws.amazon.com/pinpoint/.

  2. On the All projects page, choose the project for which you want to enable the SMS channel.

  3. In the navigation pane, under Settings, choose SMS.

  4. Next to General, choose Edit.

  5. Choose Enable the SMS channel for this project.

  6. Choose Save changes.

Next steps

You've created a project that's enabled for SMS messaging. Now you can use Amazon Pinpoint to send SMS messages.

Some SMS options, such as dedicated origination numbers or sender IDs, are unavailable until you contact AWS Support. For more information, see Requesting support for SMS messaging with Amazon Pinpoint.

To engage an audience segment with an SMS campaign, see Amazon Pinpoint campaigns.

To send an SMS message directly to a limited audience without creating a campaign, see Send test messages with Amazon Pinpoint.