Skip to main content
POST
/
emails
/
v1.0
/
bulk-resubscribe
Bulk Resubscribe Users
curl --request POST \
  --url https://api-0{X}.moengage.com/emails/v1.0/bulk-resubscribe \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'MOE-APPKEY: <moe-appkey>' \
  --data '
{
  "recipients": [
    "[email protected]",
    "[email protected]",
    "[email protected]"
  ],
  "update_esp": true,
  "esp": "SENDGRID",
  "request_id": "636b77e6e2cf83277195fb60"
}
'
{
  "message": "The request is submitted successfully.",
  "response_id": "SrTuWVlPsq"
}

​
Supported ESPs

The Resubscription API currently supports only SendGrid.

​
Rate Limit

The rate limit is 10 RPM (requests per minute). The allowed volume is 14.4K requests per day, with a maximum payload size of 100 recipient email addresses per request.

Authorizations

​
Authorization
string
header
required

Authentication is done via Basic Auth. This requires a base64-encoded string of your credentials in the format 'username:password'.

  • Username: Use your MoEngage workspace ID (also known as the App ID). You can find it in the MoEngage dashboard at Settings > Account > APIs > Workspace ID (earlier app id).
  • Password: Use your API Key, which you can find within the Data tile.

For more information on authentication and getting your credentials, refer here.

Headers

​
MOE-APPKEY
string
required

This is the Workspace ID of your MoEngage account that must be passed with the request. You can find it in the MoEngage dashboard at Settings > Account > APIs > Workspace ID (earlier app id).

Body

application/json

List of recipients to resubscribe and ESP preference.

​
recipients
string
required

This field contains the email ids of the users who have resubscribed. Note: If an email address matches multiple profiles, all the profiles will be marked as resubscribed on the MoEngage dashboard (the unsubscribe flag will be set to false for the user).

Example:
["[email protected]", "[email protected]"]
​
esp
string
required

This field contains information about the Email Service Provider (esp) whose suppression list needs to be updated. For example, “esp”: “SENDGRID” would imply that the email address of the customers who have resubscribed to your brand need to be removed from SendGrid’s suppression list.

​
request_id
string
required

This field contains the value of the identifier for the request.

​
customer_id
string

This field denotes the unique identifier used to identify a user in MoEngage. Note that devices can be created for existing users only.

​
update_esp
boolean

This field’s default value is false when it is not sent in the request payload. MoEngage calls the ESP to remove the email addresses from their email suppression list when this field is true.

Response

The request has been successfully submitted for asynchronous processing.

Success response body for the Bulk Resubscribe API (202 Accepted).

​
message
string

This field contains a brief description of the request status.

Example:

"The request is submitted successfully."

​
response_id
string

This field contains the unique identifier for the response and is present in the response only when the request is successful.

Example:

"SrTuWVlPsq"