• User - POST https://api.moengage.com/v1/customer?app_id=<APP ID>
• Device - POST https://api.moengage.com/v1/device?app_id=<APP ID>
• Event - POST https://api.moengage.com/v1/event?app_id=<APP ID>
• Bulk Import - POST https://api.moengage.com/v1/transition?app_id=<APP ID>
• Change User Id - POST https://api.moengage.com/v1/customer/substitute?app_id=<APP ID>

app_id: Get the APP ID from the MoEngage dashboard under following path: (Settings > App Settings > Account Settings > APP ID).

• Authentication
• Content-Type Header

Data APIs use Basic authentication to control access to your data.

Basic authentication sends a Base64-encoded string that contains a username and password for your API requests. username and password are available under following path: (Settings > APIs > DATA API Settings) as shown below.

For first time, hit the Generate Key and then save on Data APIs settings page.
User name - DATA API ID
Password - DATA API KEY

Basic Authentication encodes a 'username:password' using base64 and prepends it with the string 'Basic '. This is passed in the authorization header as follows
{"Authorization": "Basic bmF2ZWVua3VtYXI6bW9lbmdhZ2U="}

To send a request using a client (as Postman), Authentication can be done in following way:

To send data to Data APIs, Content-Type header must be set to 'application/json' as follows
{"Content-Type": "application/json"}

There is a max limit of 100kb per request.

Response will be a json object, on a sucessful call you will receive response as

on failure, response will be

The MoEngage Data Import API is designed to handle high volumes of data across our customer base. We enforce API limits to ensure responsible use of the API.

Recommended rate limits of the Data Import APIs are as below -

Events - A single API request (Event / Bulk Import API) can contain one or more than one events. You should maintain a rate limit of 10000 events per minute.

Users - A single API request (User / Bulk Import API) can contain one or more than one user updates. You should maintain a rate limit of 1000 user updates per minute.

Please note that on exceeding the recommended rate limits, there is a possibility that your data processing may get delayed or your account may get blocked.

If you need to exceed the recommended limits or have any questions on the API limits, please contact your Customer Success Manager or send an email to our Support Team at support@moengage.com.

API to use - User API
This API allows you to create a new user profile (or) update profile data of existing user. It includes customer_id (Unique Identifier of User) and other User Attributes(ex: name, age etc.. ). customer_id will be used to Map Actions and Devices to User.

NOTE: customer_id is essentially the Unique Identifier which is set and passed on from MoEngage SDK as USER_ATTRIBUTE_UNIQUE_ID

customer_id in customer payload is mandatory to identify a user profile.
platforms in customer attributes is mandatory to track platform level analytics.

Signature for a user API request looks like:

To set name as John for a user with unique id john@example.com and platform android, pass the following payload

User attributes list is mentioned below:

• name (string) - name of the user
• first_name (string) - first name of the user
• last_name (string) - last name of the user
• email (string) - email of the user
• age (numeric) - age of the user
• gender (string) - "male" or "female" - case sensitive
• mobile (string) - phone number of the user
• geo (array of lat,lng in double) - location of the user for eg. [23.3,37.3]
• source (string) - acquisition source of the user
• created_time (numeric - epoch time in seconds) - user created time
• last_seen (numeric - epoch time in seconds) - user last seen time
• transactions (numeric) - no.of transactions done by the user
• revenue (numeric) - LTV of the user
• platforms (array) - platforms on which the user has interacted with the system. for eg.[{"platform":"ANDROID", "active":"true"},{"platform":"WINDOWS", "active":"true"},{"platform":"IOS", "active":"true"}]

To pass other attributes which are not part of the list, use the key value pairs that you intend to use. for ex. to set the points attribute for the user to 20

Mandatory fields: customer_id and platforms.

API to use - Device API
This API allows you to create a new device profile (or) update profile data of existing device. It includes customer_id (Identifier of User), device_id (Identifier of Device) and other Device Attributes(ex: model, brand, os version etc.. ).

NOTE: customer_id is essentially the Unique Identifier which is set and passed on from MoEngage SDK as USER_ATTRIBUTE_UNIQUE_ID

customer_id in device payload is mandatory to map device to user.
platform in device attributes is mandatory to run platform level campaigns.
device_id in device payload is optional and default value is customer_id value. It will be used to update specific device in future.

Signature for a device API request looks like:

We defined reserved keywords for some of Device Attributes.

To pass other attributes which aren't part of the list, use the key value pairs that you intend to use. for ex. to set the brand attribute for the device to Apple

Mandatory fields: customer_id, platform and push_id.

API to use - Event API
This API allows you to track actions of a user.

customer_id in event payload is mandatory to map event to user.
platform in event payload is mandatory to run platform level campaigns.
device_id in event payload is optional and default value is customer_id value. It will be used to map event to specific device.

Signature for event API request looks like:

We defined reserved keywords for some of Device Attributes.

Mandatory fields: customer_id, action and platform.

API to use - Transition API
This API allows you to import “user , device and event requests” in a single batch.

Signature for transition API request looks like:

API to use - Customer Substitute API
This API is used to Update Unique Id of User (customer_id).

Signature for user substitute API request looks like:

If you would like to send some events, that are meant to be considered for smart triggers, you should pass additional flag as part of events.

You should use an additional key "real_time_action": "true" in the API request which can be added while sending the events to us.

PFB the sample request:

{
"type": "event",
"customer_id": "1234567890",
"actions": [{
"action": "Set MPIN Failure",
"real_time_action": "true",
"attributes": {
"date": "2017-02-06T15:49:28.744Z"
},
"platform": "IOS",
"app_version": "2140",
"user_time": "1486376368",
"current_time": "1486376368"
}]
}

The presence of this key in your request tells our system that these events have to be considered for smart triggers.