Skip to main content
POST
Submit a GDPR / CCPA Data Request
Warning: Multiple users cannot be deleted using this API in a single payload. If an email ID associated with multiple users is passed for an erasure request, all associated users will be deleted.

Rate Limit

The maximum limit per request is 100 KB. The maximum payload size is 128 KB.

承認

Authorization
string
header
必須

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.

パスパラメータ

appId
string
必須

This is your MoEngage account's Workspace ID that must be included in the request. You can find your Workspace ID in the following navigation on the dashboard: Revamped UI: Settings > Account > APIs > Workspace ID

ボディ

application/json

The GDPR/CCPA request payload, containing the type of request and the user identities.

The main object representing a GDPR or CCPA compliance request.

request_type
string
必須

This is used to request for GDPR details or request to erase the GDPR details

例:

"erasure"

submitted_time
string<date-time>
必須

This identifies the time when the request was sent.

例:

"2018-10-05T15:00:00Z"

identities
object[]
必須

This provides the details of the user, such as email address, phone number, and so on.

api_version
string
必須

This identifies the API version used to send the GDPR request.

例:

"1.0"

レスポンス

Success. This response is returned when the request is processed successfully.

Standard successful response object for a submitted GDPR request.

status
string
例:

"success"

message
string

A human-readable message confirming the request was accepted.

例:

"Your request has been accepted and will be processed soon."

request_id
string<uuid>

A unique ID generated for the submitted request.

例:

"a7551968-d5d6-44b2-9831-815ac9017798"