Amazon Pinpoint
User Guide

Prerequisites

In order to complete the steps in this tutorial, you have to complete a few prerequisite steps first. This section provides procedures for creating your AWS account, creating an IAM user, and installing and configuring the AWS CLI.

Create an AWS Account

If you haven't done so already, you have to create an AWS account before you can use Amazon Pinpoint or other AWS services.

To create an AWS account

  1. Go to https://console.aws.amazon.com/pinpoint/, and choose Get Started with Amazon Pinpoint.

  2. Follow the on-screen instructions to create your account.

Create an IAM User and Obtain Credentials

To send email using Amazon Pinpoint, you have to create an IAM user account. When you create your account, you're provided with a set of credentials that you use to configure the AWS CLI.

To create an account and obtain your credentials

  1. Open the IAM console at https://console.aws.amazon.com/iam/.

  2. In the navigation pane, choose Users.

  3. Choose Add user.

  4. Under Set user details, for User name, type a name for your user account.

  5. Under Select AWS access type, do the following:

    1. For Access Type, select Programmatic access and AWS Management Console access.

    2. For Console password, select Autogenerated password.

    3. Select Require password reset.

    4. Choose Next: Permissions.

  6. On the Set permissions page, do the following:

    1. Choose Attach existing policies directly.

    2. In the list of policies, choose PowerUserAccess.

      Tip

      To quickly find this role, use the search box at the top of the list of user roles.

    3. Choose Next: Review.

  7. Choose Create user. The IAM console shows a list of the users that it just created.

  8. Choose Download .csv. Save the .csv file to your computer, and then open the file. You need the values in the Access key ID and Secret access key columns to configure the AWS CLI.

Install the AWS CLI

Now that you've created an IAM user, you can install the AWS CLI. The process for installing the AWS CLI depends on what kind of computer you use.

Installing the AWS CLI on a Windows-based Computer

If you use a Windows-based computer, you can download a file that installs the AWS CLI to your computer.

To install the AWS CLI on a Windows-based computer

  1. Download the AWS CLI installer from https://s3.amazonaws.com/aws-cli/AWSCLI64.msi.

  2. Double-click the file that you downloaded to run the installer. Follow the instructions to install the AWS CLI on your computer.

  3. Press the Windows key+R. The Run window appears.

  4. Type cmd.exe, and then press Enter. Windows Command Prompt opens.

  5. At the command prompt, type the following command, and then press Enter.

    cd "c:\Program Files\Amazon\AWSCLI"

    Keep the Command Prompt window open.

Installing the AWS CLI on a macOS-based Computer

If you use a macOS-based computer, you can use the built-in pip command to download and install the AWS CLI.

To install the AWS CLI on a macOS-based computer

  1. On the macOS menu bar, choose the Spotlight ( ) icon. Type Terminal, and then press Return. The macOS Terminal application opens.

  2. At the command line, type the following command, and then press Return:

    pip install awscli --upgrade --user

    Keep the terminal window open, and proceed to the next section.

Installing the AWS CLI on a Linux-based Computer

If you use a Linux-based computer, you can use the built-in pip command to download and install the AWS CLI.

To install the AWS CLI on a Linux-based computer

  1. Open the terminal emulator.

  2. At the command line, type the following command, and then press Enter:

    pip install awscli --upgrade --user

    Keep the terminal window open, and proceed to the next section.

Configure the AWS CLI

After you install the AWS CLI, you have to configure it to use the credentials that are associated with your IAM user.

To configure the AWS CLI

  1. At the command line, type the following command, and then press Enter:

    aws configure
  2. When prompted, provide the AWS Access Key ID and AWS Secret Access Key values from the spreadsheet you downloaded when you created your IAM user account.

  3. For Default region name, type us-east-1.

  4. For Default output format, press Enter.

    Keep the Command Prompt or terminal window open, and proceed to the next section.

Next: Create a Project »