Amazon Pinpoint
User Guide

Setting up 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.

You can also enable the SMS channel for an existing project by using the Settings page in the Amazon Pinpoint console. For more information, see Managing the Amazon Pinpoint SMS Channel.

Creating a New Project by Using the Amazon Pinpoint Console

The first step in setting up email in Amazon Pinpoint is to create a new project. Next, you verify an email address identity.

In Amazon Pinpoint, an identity is an email address or domain that you use to send email. Before you can send email using Amazon Pinpoint, you must verify each identity that you plan to use as a "From", "Source", "Sender", or "Return-Path" address to prove that you own it. If your account is still in the Amazon Pinpoint sandbox, you also need to verify the identities that you plan to send emails to.

To create a new Amazon Pinpoint project and verify an email address

  1. Open the Amazon Pinpoint console at

  2. On the Projects page, choose Create a project.

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


    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 Messaging channels, next to SMS, 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 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 spend limit – The maximum amount of money, in US Dollars, that you want to spend sending SMS messages per calendar month. If your monthly sending exceeds this limit, Amazon Pinpoint and other AWS services stop sending SMS messages from your account.

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


    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 send SMS messages, such as Amazon SNS.

  7. When you finish, 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.