Documentation / Product / Integrations / Amazon Web Services / Amazon Pinpoint

Amazon Pinpoint: Export Audiences

Export Lytics audiences to add audience membership data to your Pinpoint endpoints, and send targeted notifications using Pinpoint as users enter or exit Lytics audiences.

Integration Details

This integration utilizes the Pinpoint REST APIs to send Pinpoint events that set an attribute for a Pinpoint Endpoint as a user enters or exits an audience in Lytics.

  1. As users enter or exit the Lytics audience, a new event is sent with the identifier lytics_audience with the slug of the exported Lytics audience. For example, lytics_highly_engaged is sent with the value true if they have entered the audience, and false if they have exited the audience.
  2. When building a campaign in Pinpoint, this attribute can be used to trigger a send event. In the Pinpoint campaign setup step "Choose when to send the campaign" you can target the attribute Lytics Audience for when the exported Lytics audience slug is set to true.
  3. The Lytics audience is also added as a Pinpoint endpoint attribute which can be used in Pinpoint to create custom segments.


By default, Lytics exports the following fields to Pinpoint.

Lytics User FieldDescriptionPinpoint FieldType
customAddress FieldAddress for channelstring
AudienceExported Audiencelytics_audiencebool


Follow these steps to set up and configure an export of a Lytics audience to Pinpoint. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.

  1. Select Amazon AWS Services from the list of providers.
  2. Select the Export Audiences job type from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. From the Audience input, select Lytics Audiences to emit events from. Each enter/exit event from the selected audience will be sent as a Pinpoint email event.
  7. From the Region input, select the AWS region that Pinpoint resides in (e.g. us-east-2).
  8. From the Pinpoint Project input, select your Pinpoint Project.
  9. From the Pinpoint Channel Type input, select the channel type, e.g., Email or SMS, to send to (channel must first be activated in Pinpoint).
  10. From the Address Field input, select the Lytics field that contains the user's endpoint address for the selected channel, e.g. "Email Address" if the selected channel type is "EMAIL".
  11. (Optional) From the User ID Field input, select the Lytics field that contains the user's unique ID that is used in Pinpoint to tie channel endpoints together.
  12. Select the Existing Users checkbox to send an enter event for users who are already in the selected Lytics audience.
  13. Click Start Export. pinpoint export

If the Existing Users option is selected, audience data should be in Pinpoint within minutes. Otherwise, data will be seen when a new user enters or exits the exported audience.

In Pinpoint, segments can be created to target the Lytics audience by defining a segment with the exported Lytics segment slug name set to true.

pinpoin segment