**End of support notice:** On October 30, 2026, AWS will end support for Amazon Pinpoint. After October 30, 2026, you will no longer be able to access the Amazon Pinpoint console or Amazon Pinpoint resources (endpoints, segments, campaigns, journeys, and analytics). For more information, see [Amazon Pinpoint end of support](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Note:** APIs related to SMS, voice, mobile push, OTP, and phone number validate are not impacted by this change and are supported by AWS End User Messaging.
# Getting started with Amazon Pinpoint
To start sending targeted messages in Amazon Pinpoint, you have to complete a few steps. For example, you have to add customer contact information into Amazon Pinpoint, and then create segments that target certain customers. Next, you have to create your messages and schedule your campaigns. Finally, after you send your campaigns, you can use the analytics dashboards that are built into Amazon Pinpoint to see how well the campaigns performed.
This tutorial includes procedures for all steps involved in sending an email campaign to a segment of customers with the Amazon Pinpoint console.
**Note**
As soon as you set up a new Amazon Pinpoint account, it is placed in a sandbox for email, SMS, and voice message channels until you request production access. In the sandbox, you can access all of Amazon Pinpoint's features, with the following restrictions on your email, SMS, and voice messages:
For email sandbox restrictions, see [Amazon Pinpoint email sandbox](channels-email-setup-production-access.md).
For SMS sandbox restrictions, see [SMS sandbox ](https://docs.aws.amazon.com//sms-voice/latest/userguide/sandbox.html#sandbox-sms) in the *AWS End User Messaging SMS User Guide*.
For voice sandbox restrictions, see [Voice sandbox ](https://docs.aws.amazon.com//sms-voice/latest/userguide/sandbox.html#sandbox-voice) in the *AWS End User Messaging SMS User Guide*.
There are no Amazon Pinpoint sandbox restrictions for push notifications.
To move to production access from the sandbox, create an AWS Support case for a **Service limit increase** request for each channel you want to move.
## About this tutorial
This section contains an overview of this tutorial.
**Intended Audience**
This tutorial is designed for marketing and business users.
If you're a software developer or system administrator, you might also find the [tutorials](https://docs.aws.amazon.com/pinpoint/latest/developerguide/tutorials.html) in the *Amazon Pinpoint Developer Guide* to be useful.
**Features Used**
This tutorial shows you how to complete all of the following steps by using the Amazon Pinpoint console:
+ Importing customer data from a file.
+ Creating a segment that targets specific users based on their attributes.
+ Creating an email campaign and scheduling it to be sent at a specific time.
+ Viewing email delivery and response data by using the analytics dashboards that are built into Amazon Pinpoint.
**Time Required**
It should take about 30–45 minutes to complete this tutorial.
**Regional Restrictions**
There are no regional restrictions associated with using this solution.
**Resource Usage Costs**
There's no charge for creating an AWS account. However, by implementing this solution, you might incur some or all of the costs that are listed in the following table.
| Description | Cost (US dollars) |
| --- | --- |
| Message sending costs | You pay \$10.0001 for each email that you send through Amazon Pinpoint. |
| Monthly targeted audience costs | You pay \$10 for the first 5,000 endpoints that you target in Amazon Pinpoint each month. (An endpoint is a destination that you can send messages to, such as a user's email address or mobile phone number.) After that, you pay \$10.0012 per endpoint that you target. |
If you use this tutorial to send 5 messages to 5 separate endpoints in one month, you incur charges of \$10.0005.
For detailed information about the costs that you might incur using Amazon Pinpoint, see [Amazon Pinpoint pricing](https://aws.amazon.com/pinpoint/pricing/).
**Next:** [Create and Configure a Project](gettingstarted-create-project.md)
# Create and configure a project
In Amazon Pinpoint, a *project* is a collection of settings, customer information, segments, and campaigns. If you're new to Amazon Pinpoint, the first step you should take is to create a project.
**Note**
If you've used the Amazon Pinpoint API, you might have seen references to "applications." In Amazon Pinpoint, a *project* is the same as an *application*.
This section shows you how to create a project. As part of this procedure, you verify an email address and grant Amazon Pinpoint access to use your Amazon SES resources to send email from a campaign. The verified email address is used as the sender email address when you create your email campaign later in this tutorial.
## Create and configure a project
The procedures in this section show you how to create a project and verify an email address.
**To create a project and verify an email address**
1. Sign in to the AWS Management Console and open the Amazon Pinpoint console at [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/).
1. If this is your first time using Amazon Pinpoint, you see a page that introduces you to the features of the service.
In the **Get started** section, enter a name for your project, and then choose **Create a project**.
**Note**
The project name can contain up to 64 characters.
1. On the **Configure features** page, next to **Email**, choose **Configure**.
1. For **Email address**, type an email address that you want to use to send email. For example, you can use your personal email address, or your work email address. Choose **Verify**.
1. Wait for 1–2 minutes, and then check the inbox for the email address that you specified in step 4. You should see an email from *Amazon Web Services (no-reply-aws@amazon.com)* with the subject line "Amazon Web Services – Email Address Verification Request in Region *RegionName*", where *RegionName* is the name of the AWS Region that you're configuring Amazon Pinpoint in.
1. Open the email, and then click the link in the body of the email.
1. Return to the Amazon Pinpoint console in your browser. On the **Set up email** page, choose **Save**.
## Create an orchestration sending role arn
You must create an **Orchestration sending role arn** to grant Amazon Pinpoint access to use your Amazon SES resources to be able to send email from a campaign or journey. If you already have an **Orchestration sending role arn**, then you can choose to use that role in step 6.
**Create orchestration sending role arn**
1. Open the Amazon Pinpoint console at [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/).
1. On the **All projects** page, choose the project that you want to update email settings for.
1. In the navigation pane, under **Settings**, choose **Email**.
1. On the **Identities** tab, choose **Edit**.
1. Choose **Enable campaigns and journeys for this email channel**.
1. For **IAM role** choose either:
+ **Create a new role** (Recommended) – To have Amazon Pinpoint create the IAM role and configure the IAM roles permissions. Enter a name for the IAM role in **IAM role name**.
+ **Use an existing role** – If you have an existing IAM role that already contains permissions to allow Amazon Pinpoint access to `ses:SendEmail` and `ses:SendRawEmail` then choose that IAM role from the drop down list. If you need to create the IAM role, see [IAM role for sending email through Amazon SES](https://docs.aws.amazon.com/pinpoint/latest/developerguide/permissions-ses.html) in the [Amazon Pinpoint Developer Guide](https://docs.aws.amazon.com/pinpoint/latest/developerguide/).
1. Choose **I acknowledge that the IAM role I selected has the required permissions.**
1. Choose **Save**.
**Next:** [Import customer data and create a segment](gettingstarted-import-customer-data.md)
# Import customer data and create a segment
A *segment* is a group of your customers that share certain attributes. For example, a segment might contain all of your customers who use version 2.0 of your app on an Android device, or all customers who live in the city of Los Angeles.
When you create a campaign, you have to choose a segment to send the campaign to. You can send multiple campaigns to a single segment, and you can send a single campaign to multiple segments.
There are two types of segments that you can create in Amazon Pinpoint:
+ **Dynamic segments** – Segments that are based on attributes that you define. Dynamic segments can change over time. For example, if you add new endpoints to Amazon Pinpoint, or if you modify or delete existing endpoints, the number of endpoints in that segment may increase or decrease. For more information about dynamic segments, see [Building segments](segments-building.md).
+ **Imported segments** – Segments that are created outside of Amazon Pinpoint and saved in CSV or JSON format. Imported segments are static—that is, they never change. When you create a new segment, you can use an imported segment as a base segment, and then refine it by adding filters. For more information about importing segments, see [Importing segments](segments-importing.md).
In this tutorial, you create an imported segment by uploading a file from your computer. Next, you create a dynamic segment that is based upon the imported segment.
## Download and modify the sample file
In this section, you download a file that contains fictitious customer data. You also modify the data to include your own contact information. Later in this tutorial, you use this data to create a segment.
1. In a web browser, download the sample file from [the GitHub user content website](https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-user-guide/main/examples/Pinpoint_Sample_Import.csv). Save the file to your computer.
**Tip**
You can quickly save this file to your computer by right-clicking the link, and then choosing **Save Link As**. Some browsers may download the file with the **txt** file extension name. Before downloading and saving the file make sure that the extension is changed to **csv**.
1. Open the file in a spreadsheet application. On the last row of the file, replace the items in angle brackets (`<…>`) with your own contact information.
In the `Address` column, enter the same email address that you verified in [Create and configure a project](gettingstarted-create-project.md). The message that you send in this campaign will be sent to that address.
1. When you finish, save the file.
**Note**
If you used a spreadsheet application to modify the file, make sure that you save the modified file in Comma-Separated Values (.csv) format. Amazon Pinpoint can't import proprietary file formats, such as .xlsx.
## Import the sample customer data file
Now that you have a file that contains customer data, you can import it into Amazon Pinpoint. To import customer data, you have to create a new segment.
**To create an imported segment**
1. In the Amazon Pinpoint console, in the navigation pane, choose **Segments**.
1. Choose **Create a segment**.
1. On the **Create a segment** page, choose **Import a segment**.
1. In the **Specifications** section, under **Import method**, choose **Upload files from your computer**.
1. Select **Choose files**. Navigate to the `Pinpoint_Sample_Import.csv` file that you downloaded and modified in the previous section.
1. Choose **Create segment**. Amazon Pinpoint copies the file from your computer and creates a segment. Wait for about 1 minute while the import completes.
## Create a targeted segment
Your Amazon Pinpoint project now contains some customer data, and a segment that contains your entire customer list. It also contains your contact information.
In this section, you create a targeted segment. You add segment criteria that filter the segment so that you're the only member of the segment.
**To create the segment**
1. On the **Segments** page, choose **Create a segment**.
1. On the **Create a segment** page, choose **Build a segment**.
1. For **Name**, enter a name for the segment.
1. Under **Segment group 1**, do the following:
1. Next to **Include endpoints that are in any of the following segments**, choose the **Pinpoint\$1Sample\$1Import** segment that you created in the previous step.
1. Choose **Add criteria**.
1. From the menu under **Attribute**, choose **Channel Types > Email**.
1. Choose **Add filter**.
1. In the new menu that appears in the **Attribute** column, choose **Custom User Attributes > Company**. Next, in the **Operator** column, choose **Is**. Finally, in the **Values** column, enter the unique company name that you specified for your own contact record in [Download and modify the sample file](#gettingstarted-import-customer-data-download-sample-file).
1. Choose **Create segment**.
**Next:** [Create and schedule a campaign](gettingstarted-create-campaign.md)
# Create and schedule a campaign
A *campaign* is a messaging initiative that engages a specific audience segment. A campaign sends tailored messages on the days and times that you specify. You can use the console to create a campaign that sends messages through the email, push notification, or SMS channels.
In this section, you create an email campaign. You create a new campaign, choose your target segment, and create a responsive email message for the campaign. When you finish setting up the message, you choose the day and time when you want the message to be sent.
## Create the campaign and choose a segment
When you create a segment, you first give the segment a name. Next, you choose the segment that the campaign applies to. In this tutorial, you choose the segment that you created in [Import the sample customer data file](gettingstarted-import-customer-data.md#gettingstarted-import-customer-data-import-segment).
**To create the campaign and choose segment**
1. In the Amazon Pinpoint console, in the navigation pane, choose **Campaigns**.
1. Choose **Create a campaign**.
1. Under **Campaign details**, for **Campaign name**, enter a name for the campaign.
1. For **Campaign type**, choose **Standard campaign**.
1. For **Choose a channel for this campaign**, choose **Email**.
1. Choose **Next**.
1. On the **Choose a segment** page, choose **Use an existing segment**. Then, for **Segment**, choose the targeted segment that you created in [Create a targeted segment](gettingstarted-import-customer-data.md#gettingstarted-import-customer-data-create-targeted-segment). Choose **Next**.
## Create the campaign message
After you specify a campaign name and choose a segment, you can create your message. This tutorial includes a link to an HTML file that you can use to create your message.
This sample file uses responsive HTML to create a message that renders properly on both computers and mobile devices. It uses inline CSS to provide compatibility with a wide variety of email clients. It also includes tags that are used to personalize the message with the recipient's name and other personal information.
**To create the message**
1. On the **Create your message** page, under **Message content**, choose **Create a new message**.
1. For **Subject**, enter a subject line for the email.
1. In a web browser, download the sample file from [the GitHub user content website](https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-user-guide/main/examples/Pinpoint_Sample_Email.html). Save the file to your computer.
**Tip**
You can quickly save this file to your computer by right-clicking the link, and then choosing **Save Link As**. Otherwise, you can click the link to open the HTML text in a browser tab. Keep the tab open until you've completed Step 4.
1. Open the file that you just downloaded in a text editor, such as Notepad (Windows) or TextEdit (macOS). If you opened the file in a browser tab then select that tab. Press **Ctrl\$1A** (Windows) or **Cmd\$1A** (macOS) to select all of the text. Then, press **Ctrl\$1C** (Windows) or **Cmd\$1C** (macOS) to copy it.
1. Under **Message**, erase the sample HTML code that's shown in the editor. Paste the HTML code that you copied in the last step.
1. (Optional) Modify the content of the message to include a message that you want to send.
You can personalize the message for each recipient by including the name of an attribute inside two sets of curly braces. For example, the sample message includes the following text: `{{User.UserAttributes.FirstName}}`. This code represents the User.UserAttributes.FirstName attribute, which contains the recipient's first name. When you send the campaign, Amazon Pinpoint removes this attribute name and replaces it with the appropriate value for each recipient.
You can experiment with other attribute names. Refer to the column headers in the spreadsheet that you imported in [Import the sample customer data file](gettingstarted-import-customer-data.md#gettingstarted-import-customer-data-import-segment) for a complete list of attribute names that you can specify in your message.
**Tip**
You can use Design view to edit the content of the message without having to edit the HTML code. To use this view, choose **Design** from the view selector above the message editor, as shown in the following image.
![\[\]](http://docs.aws.amazon.com/pinpoint/latest/userguide/images/gettingstarted-create-campaign-design-menu.png)
1. In **Email settings** for **Sender email address** choose the verified email address that you created while creating the project.
1. In **Send a test email** choose **A segment** and then choose the segment you created from the dropdown list.
1. Choose **Next**.
## Schedule the campaign
The last step in creating the campaign is to choose when to send it. In Amazon Pinpoint, you can set up your campaigns so that they're sent immediately after you launch them. You can also schedule them to be sent in the future—anywhere from 15 minutes from the current time, to six months into the future. Finally, you can schedule your messages to be sent on a recurring basis (that is, hourly, daily, weekly, or monthly). Recurring campaigns are a great way to send account or status updates where the appearance of the campaign message stays the same over time, but is populated with information that changes dynamically.
In this section, you schedule your campaign to be sent immediately after you launch it.
**To schedule the campaign**
1. On the **Choose when to send the campaign** page, choose **At a specific time**. Then, under **Choose when the campaign should be sent**, choose **Immediately**. Finally, choose **Next**.
1. On the **Review and launch** page, review all of the details of the campaign. When you're ready to send it, choose **Launch campaign**.
Congratulations—you've created your first campaign with Amazon Pinpoint\$1 Because you're the only member of the segment that you created in [Create a targeted segment](gettingstarted-import-customer-data.md#gettingstarted-import-customer-data-create-targeted-segment), you should receive the message in your inbox within a few seconds.
**Next:** [View campaign analytics](gettingstarted-analytics.md)
# View campaign analytics
At this point, you've created a segment that you're a member of. You've also created an email campaign and sent it to yourself. In this section, you look at the delivery and response metrics for the campaign.
## Interact with your campaign
Before you can view the delivery and response metrics for your campaign, you have to interact with the message that you sent yourself in [Create and schedule a campaign](gettingstarted-create-campaign.md).
**To interact with the email**
1. In your email client, open the message that you sent yourself in [Create and schedule a campaign](gettingstarted-create-campaign.md).
1. If your email client automatically hides images by default, choose the **Download pictures** (or equivalent) button to load the images in the message.
1. Click one or more of the links that are contained in the message.
1. Wait for a few minutes, and then proceed to the next section.
## View metrics for the campaign
After you interact with the email that you sent from the campaign, you can view the metrics for the campaign.
**To view the campaign metrics**
1. Open the Amazon Pinpoint console at [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/).
1. On the **All projects** page, choose the project that you used to send the campaign.
1. In the navigation pane, under **Analytics**, choose **Campaigns**.
1. In the **Campaigns** section, choose the campaign that you created in [Create and schedule a campaign](gettingstarted-create-campaign.md).
1. (Optional) Use the date control to choose a date range for the reports on this page.
On the metrics page for your campaign, you see the following information:
+ **Delivery count metrics** – This section provides information about the delivery of the messages that were sent from your campaign. It includes the following information:
+ **Messages sent** – The number of messages that were sent.
+ **Messages delivered** – The number of messages that were delivered to their recipients.
+ **Links clicked** – The number of times that links in the messages were clicked by recipients. If a single recipient clicks a link more than once, each click is represented in this section.
+ **Endpoint deliveries** – The average number of endpoints that the campaign was sent to, for each day in the chosen date range. The chart shows the number of endpoints that the campaign was delivered to, for each day in the chosen date range.
+ **Delivery rate metrics** – This section shows the overall delivery and response rates for the messages that were sent from your campaign. It includes the following information:
+ **Delivery rate** – The percentage of messages that were delivered to recipients, of the total number of endpoints that you targeted in the segment that you sent this campaign to.
+ **Email open rate** – The percentage of messages that were opened by recipients, of the total number of messages that were delivered.
+ **Bounce rate** – The percentage of messages that weren't delivered to recipients because they bounced. This value includes only hard bounces—that is, messages that bounced because of a permanent issue. For example, hard bounces could occur when the recipient's email address doesn't exist, or when the recipient permanently rejects email from your domain.
+ **Campaign runs** – This section shows information that's specific to each time the campaign ran. Because you can use Amazon Pinpoint to create recurring campaigns, this section can show information for several campaign runs. However, if you completed the procedures in this tutorial, this section contains information for only one campaign run because you ran the campaign only once. This section contains the following metrics, in addition to the metrics that are defined in the preceding sections:
+ **Endpoints targeted** – The number of endpoints that were targeted by the segment that was associated with the campaign run. This number includes endpoints that were part of the segment, but didn't receive the message.
+ **Total email opened** – The total number of times that messages sent from the campaign run were opened. For example, if a message was opened two times by one recipient, both of those opens are counted.
**Next:** [Next steps](gettingstarted-next-steps.md)
# Next steps
We hope that you use this tutorial as a starting point as you discover the additional capabilities of Amazon Pinpoint. For example:
+ You can improve the delivery of your email campaigns by making sure that your campaigns align with industry best practices. For more information, see [Email best practices](channels-email-best-practices.md).
+ You can verify an entire domain, which allows you to send email from any address on that domain. For more information about verifying domains, see [Verifying a domain](channels-email-manage-verify.md#channels-email-manage-verify-domain).
+ You can obtain dedicated IP addresses for sending your email. Dedicated IP addresses are a great option for sending email in certain use cases. For more information, see [Using dedicated IP addresses with Amazon Pinpoint](channels-email-dedicated-ips.md).
+ You can enable the Amazon Pinpoint Deliverability dashboard. The Deliverability dashboard helps you identify issues that could impact the delivery of your emails. For more information, see [The Amazon Pinpoint Deliverability dashboard](channels-email-deliverability-dashboard.md).
+ You can send messages through other channels, such as SMS or push. Before you can use these channels, you have to enable and configure them on the Settings page. For more information about using the Settings page to enable and configure channels, see [Amazon Pinpoint channels](channels.md).
+ You can send data about your campaigns outside of Amazon Pinpoint. For example, you can send delivery and response data for your campaigns to Amazon S3 for long-term storage. You can also send data to Amazon Redshift to perform custom analyses. For more information about sending your data outside of Amazon Pinpoint, see [Streaming events with Amazon Pinpoint](analytics-streaming.md).
+ You can integrate Amazon Pinpoint with your apps, or interact with Amazon Pinpoint programmatically, by using an AWS SDK. For more information, see the [Amazon Pinpoint Developer Guide](https://docs.aws.amazon.com/pinpoint/latest/developerguide/).