Amazon Pinpoint
User Guide

Step 2: Upload a List of Segment Members to Amazon S3

To create a segment of customers that you can use with this tutorial in Amazon Pinpoint, you first have to upload a spreadsheet that contains those customers' contact details to an Amazon S3 bucket.

In Amazon S3, a bucket is a container that you use to store files and folders. Each bucket can have its own permission settings. For example, you can set up a bucket so that its contents are accessible to anyone who has the address of the bucket. Or you could set it up so that its contents are only available to you. To learn more about Amazon S3, see Introduction to Amazon S3 in the Amazon Simple Storage Service Developer Guide.

To create a list of contacts and upload it to Amazon S3

  1. In a spreadsheet application, create a spreadsheet that contains information about the contacts that you want to send email to. Use the following template as an example. Change the values in the Address, User.UserAttributes.FirstName, and User.UserAttributes.LastName fields to represent the people who you want to contact. Don't change the column headings or the values in the ChannelType column.

    ChannelType Address User.UserAttributes.FirstName User.UserAttributes.LastName
    EMAIL John Stiles
    EMAIL Xiulan Wang
    EMAIL Carlos Salazar


    You can include additional fields if necessary. For a list of other fields you can specify, see the table in Available Attributes.

  2. Replace the values in the template with names and email addresses of people you want to contact.


    If this is your first time using Amazon Pinpoint, your account is in the sandbox. When your account is in the sandbox, you can only send email to verified identities. If you want to send email to identities you haven't verified, complete the procedure in Requesting Production Access for Email.

    When you finish, save the file to your computer in comma-separated values (CSV) format.

  3. Open the Amazon S3 console at

  4. Choose Create bucket.

  5. On the Create bucket dialog box, for Bucket name, type a name for the bucket, and then choose Create.

  6. In the list of buckets, choose the bucket that you created in the previous step.

  7. Choose Create folder. Type a name for the folder, and then choose Save.

    Make a note of both the name of the bucket and the name of the folder (you need to provide both of these values in a later step).

  8. In the folder you just created, choose Upload, and then choose Add files. Upload the spreadsheet that you created earlier in this section.

Next: Create a Segment »