How to permanently delete a participant

Use this guide when you need to completely and permanently remove a participant account from the system. This action cannot be undone.

⚠️ This is a hard delete. The account is removed from the system entirely, including all associated data. If you only want to remove the participant from a specific event while keeping their account, use the "How to detach a participant from an event" guide instead.

Prerequisites

Your API key
The participant's internal id, email, or external_id

Request — delete by internal ID

Bash

curl -X DELETE "https://your-event-domain.com/api/v2/account/delete?id=12345" \
  -H "Authorization: Bearer your_api_key_here"

Request — delete by email

Bash

curl -X DELETE "https://your-event-domain.com/api/v2/account/delete?email=john.doe@example.com" \
  -H "Authorization: Bearer your_api_key_here"

Request — delete by External ID

Bash

curl -X DELETE "https://your-event-domain.com/api/v2/account/delete?external_id=EXT-00123" \
  -H "Authorization: Bearer your_api_key_here"

Response

JSON

{
  "code": 200,
  "data": {
    "id": 12345,
    "status": "deleted"
  },
  "response_id": "1700000000.12345"
}

Notes

The account lookup order is: id → external_id → email. The first match is used
This operation is irreversible
If no account is found for the given identifier, a 400 error is returned