File Import Overview

Fetch the processing status at both the import and file levels using the MoEngage File Imports API.

Overview

The File Imports API helps in proactively tracking the status of the Imports and the Files in an import without navigating to the MoEngage dashboard.

Use Cases

• The ability to fetch the processing status of all imports for a given date range without navigating to the MoEngage dashboard.
• The ability to proactively alert about failures in automated campaigns. For example, if an automated campaign must run using the updated list of users ingested into MoEngage through the import option, but if the import fails for any reason, it may impact the reachability of your campaigns. Typically, you become aware of import failure only when navigating to the MoEngage dashboard or when you receive an email alert. However, with this API, you can track the status proactively even before the campaign is impacted.

File Import API Endpoints

• Trigger File Imports API
• Import Details API
• Import File Run History API

Rate Limits

To ensure system stability, the following rate limits are applied per workspace:

Endpoint	Limit
Trigger File Imports	This API can be triggered once in every five minutes for a specific schedule_id. A Bad request response (400) response will be sent if this is exceeded.
Import Details	The rate limit is 50 requests per minute.
Import File Run History	The rate limit is 50 requests per minute.

FAQs

Trigger File Imports

Does the trigger API change the import schedule?

No, the schedule still remains the same as originally set up in the MoEngage Dashboard.

Postman Collection

Test these endpoints quickly by importing our Postman collection:

• Trigger File Imports: View in Postman
• Import Details: View in Postman
• Import File Run History: View in Postman