How to detach a participant from an event
Use this guide when you need to unregister a participant from a specific event while keeping their account in the system. This is useful when a participant cancels their attendance but may attend future events.
Prerequisites
-
Your API key
-
The participant's internal
id,email, orexternal_id -
The
event_idto detach them from
Request — detach by internal ID
Bash
curl -X DELETE "https://your-event-domain.com/api/v2/account/delete?id=12345&from_event=true&event_id=7" \
-H "Authorization: Bearer your_api_key_here"
Request — detach by email
Bash
curl -X DELETE "https://your-event-domain.com/api/v2/account/delete?email=john.doe@example.com&from_event=true&event_id=7" \
-H "Authorization: Bearer your_api_key_here"
Request — detach by External ID
Bash
curl -X DELETE "https://your-event-domain.com/api/v2/account/delete?external_id=EXT-00123&from_event=true&event_id=7" \
-H "Authorization: Bearer your_api_key_here"
Response
JSON
{
"code": 200,
"data": {
"id": 12345,
"status": "Account removed from event with ID 7 succesfully"
},
"response_id": "1700000000.12345"
}
Notes
-
The account is not deleted — it remains in the system and can be re-registered for future events
-
from_event=trueandevent_idmust both be present for a detachment -
If the account is not registered for the specified event, a
400error is returned -
To permanently delete an account, see the "How to permanently delete a participant" guide