Introduction

Amperity is an Intelligent Customer Data Platform that empowers global consumer brands by unlocking customer data. Amperity provides intelligent capabilities across data management, unification, analytics, insights, and activation. This integration is maintained by Amperity.

MoEngage × Amperity

Using the MoEngage and Amperity integration, you can create a unified view of your customers and run hyper-personalized campaigns. With this integration, you can:

Sync customer profiles: Send customer profiles and custom attributes from Amperity directly to MoEngage in real time.
Sync customer audiences: Build segments in Amperity and push them to MoEngage for targeted campaigns.
Manage data updates: Control the frequency and scope of attribute updates sent to MoEngage.

Ready to target SegmentData synced from Amperity is built as a custom segment, helping marketers go from audience to campaign in fewer steps.

Integration Methods

MoEngage supports two methods for integrating with Amperity:

Method	How it works	Best for
Method 1: Native Connector (Recommended)	Amperity pushes data directly to MoEngage via the Data API. No intermediate storage required.	Real-time or scheduled syncs, dynamic cohort updates.
Method 2: S3 Import	Amperity exports CSV files to an Amazon S3 bucket, which MoEngage then imports via S3 Imports.	Bulk historical data loads, teams already using S3-based workflows.

Method 1: Native Connector (Recommended)

Prerequisites

Requirements

An active Amperity account.
A MoEngage account with access to Settings > Account > APIs.
Your MoEngage Workspace ID, Data API Secret, and Data Center.

Step 1: Collect Your MoEngage Configuration Details

Before setting up the destination in Amperity, collect the following credentials from your MoEngage workspace.

Field	Description
App ID	Your MoEngage Workspace ID. To find this: 1. In the MoEngage dashboard, navigate to Settings > Account > APIs. 2. Copy the value under Workspace ID (formerly known as App ID).
API Key	Your MoEngage Data API Secret key. To find this: 1. In the MoEngage dashboard, navigate to Settings > Account > APIs. 2. Copy the value under Data in the API Keys section.
Data Center	Your MoEngage Data Center number. For more information, refer to Data Centers in MoEngage.

Step 2: Add MoEngage as a Destination in Amperity

On your Amperity dashboard, navigate to Destinations >> Add Destination.
Search for and select MoEngage from the list of available plugins.

In the Select credential dialog, select an existing credential from the dropdown or choose Create new credential and fill in the following fields:

Field	Description
Name	A label to identify this credential (for example, MoEngage Data API).
Description	Optional. A short description of the credential.
App ID	Enter your App ID collected in Step 1.
API Key	Enter your Data API Secret key collected in Step 1.
Data Center	Select your Data Center.

Define the User Identifier that Amperity will use to match records in MoEngage. Select the identifier that aligns with how your workspace identifies users:

Identifier	Description
`customer_id`	A customer-assigned unique identifier (for example, a UUID or internal user ID).

Save the destination configuration.

Step 3: Add a Data Template

In the Destinations tab, open the menu for the MoEngage destination you just created and select Add Data Template.
Enter a name and description. For example:
- Name: MoEngage Audience Attributes
- Description: Send audience attributes to MoEngage.
Verify business user access settings and review all configuration details.
Ensure the template is enabled for Campaigns so AmpIQ users can access it.
Save the data template.

Step 4: Send Data to MoEngage

Once MoEngage is configured as a destination, data can be sent via two paths depending on your Amperity product access.

Sync Queries via Amp360
Sync Audiences via AmpIQ

Amp360 users can write SQL queries and configure orchestrations to send results to MoEngage on a schedule.

Step 1: Create a query in Amperity

Navigate to the Queries section and write an SQL query that returns the customer attributes you want to send to MoEngage. Include the user identifier field you selected in Step 2.For query examples, refer to the Amperity Queries Reference.

Step 2: Add an orchestration

Go to the Orchestrations section and click Add Orchestration.
Select the SQL query you created as the data source.
Select MoEngage as the destination.
Define the run frequency (for example, daily at a set time).
Save the orchestration.

Step 3: Run the orchestration

Trigger the orchestration manually to validate data delivery. Once confirmed, rely on the schedule for automated syncs.

To avoid stale data, ensure the Amperity export schedule runs before any downstream processing in MoEngage. Amperity only sends attributes that have changed since the last sync, keeping your payloads efficient.

Data Mapping

Both standard and custom attributes can be sent from Amperity to MoEngage. To ensure data flows correctly into MoEngage user profiles, map Amperity attributes to MoEngage’s exact API keys.

Standard Attributes

When sending standard attributes from Amperity, use the MoEngage API keys below so they are parsed into the correct user profile fields:

ID: uid
First Name: u_fn
Last Name: u_ln
Full Name: u_n
Birthday: u_bd (ISO 8601 format, for example, 2023-05-21T03:47:35Z)
Email Address: u_em
Mobile Number: u_mb
Gender: u_gd

Custom Attributes

Custom attributes are fields defined by your brand (for example, loyalty tiers, purchase history, or location). Unlike standard attributes, custom attributes can be named freely — but must exactly match the names already configured in your MoEngage workspace to avoid duplication. Examples include:

loyalty_status
lifetime_value
last_purchase_date
city
state

Avoid attribute name mismatchesIf an attribute name from Amperity does not match an existing attribute in MoEngage, a new custom attribute will be created. For example, sending firstname instead of the standard u_fn key will create a new attribute. Always verify attribute mapping before running a sync.

Data Points

Amperity tracks what has changed between syncs. Only attributes updated since the last sync are sent to MoEngage — minimizing unnecessary data point consumption and keeping payloads efficient. Custom attributes will only be updated for users with a matching primary identifier (customer_id) in MoEngage.

Method 2: S3 Import (Alternative)

Use this method if you prefer a file-based workflow or are already routing data through Amazon S3. Amperity exports CSV files to an S3 bucket, and MoEngage imports them via the S3 Imports feature.

Prerequisites

Requirements

Ensure you have S3 Imports enabled for your MoEngage Workspace.

Step 1: Create a MoEngage Destination on Amperity

On your Amperity Dashboard, go to Destinations >> Add Destination.

Below are some of the mandatory fields you need to select while configuring the destination from the Amperity dashboard:

Field	Description
Plugin	Select Amazon S3.
Credential Type	Select how you want Amperity to connect to your storage.
Credential	Select or create a new credential to use for this connection.
S3 Prefix	Enter a folder path and how the prefix will be. For example: `registered_user_data_`
File Format	csv
Header	Ensure to include header row in your file.

You can read about adding Amazon S3 as your Destination on Amperity.

Step 2: Add a Data Template

On your Amperity Dashboard, go to Destinations >> Add Destination.

Below are some of the mandatory fields you need to select while configuring your exports from the Amperity dashboard:

Field	Description
Plugin	Select Amazon S3.
Credential Type	Select how you want Amperity to connect to your storage.
Credential	Select or create a new credential to use for this connection.
S3 Prefix	Enter a folder path and how the prefix will be. For example: `registered_user_data_`
File Format	csv
Filename template	`{{ group_name }}_{{now \| format:'ddmmyyyy'}}.csv`
Compression	Ensure you have selected “None”.
PGP Public Key	Enter a PGP Public Key you want to use for the files.
Header	Ensure to include header row in your file.
Visibility	Ensure this destination is available for Campaigns.
File Settings	You need to send audience lists as separate files.

Step 3: Create a New Import in MoEngage

Follow these instructions to set up S3 Imports on MoEngage.

Data Mapping

MoEngage supports importing both standard and custom attributes from your S3 CSV columns. During the mapping step, you can map the following:

Names
Birthdates
Email addresses
Phone numbers
Any other custom attribute

Data Types

Supported data types include:

Boolean
Datetime
Number
String

Step 4: Send Data to MoEngage via S3

Once you have configured your Amazon S3 buckets to capture data from Amperity, you are ready to send data to MoEngage. Choose a sync method based on your Amperity product access.

Sync Queries via Amp360
Sync Audiences via AmpIQ

With Amp360, you can write queries and configure a schedule that sends results to your S3 bucket, which MoEngage then imports.

Step 1: Create a new query in Amperity

Follow this guide to build a new query on Amperity.

Step 2: Add an orchestration to forward data to your S3 Bucket

An orchestration defines the relationship between query results and a destination, including the location to which those query results will be sent and the frequency at which the orchestration will be run. Read this guide to add your newly created Destination to this orchestration.

Step 3: Running the orchestration

Run the orchestration manually to validate that it works. Once confirmed, set up a schedule.

Set the Amperity export schedule to run before the MoEngage S3 import schedule to avoid ingesting stale data.

Amperity

Introduction

MoEngage × Amperity

Integration Methods

Method 1: Native Connector (Recommended)

Prerequisites

Step 1: Collect Your MoEngage Configuration Details

Step 2: Add MoEngage as a Destination in Amperity

Step 3: Add a Data Template