Skip to main content
POST
/
v1
/
gdpr
/
delete-request
GDPR data erasure
curl --request POST \
  --url https://api.mail.gorillaa.one/v1/gdpr/delete-request \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "[email protected]",
  "confirmDelete": true,
  "reason": "<string>"
}
'
{
  "data": {
    "requestId": "gdpr_delete_1707400000000",
    "status": "completed",
    "email": "[email protected]",
    "legalBasis": "GDPR Article 17 - Right to Erasure",
    "createdAt": "2023-11-07T05:31:56Z",
    "reason": "<string>",
    "retentionExceptions": [
      "<string>"
    ],
    "erasureDetails": {
      "emailsAnonymized": 123,
      "eventsAnonymized": 123,
      "suppressionsRemoved": 123,
      "emailsDeleted": 123,
      "eventsDeleted": 123,
      "suppressionsDeleted": 123
    },
    "processedAt": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Pass your Gorillaa Mail API key as a Bearer token.

Example: Authorization: Bearer grl_live_xxxxxxxxxxxx

Keys prefixed grl_test_ operate in test mode with reduced limits.

Body

application/json
​
email
string<email>
required
​
confirmDelete
enum<boolean>
required

Must be true to confirm the deletion

Available options:
true,
false
​
reason
string
Required string length: 1 - 500

Response

Erasure request accepted

​
data
object
required

Response from POST /v1/gdpr/delete-request — GDPR Article 17 erasure request