{
"error": {
"code": "missing_identifier",
"message": "one of 'email', 'cnvContactId', or 'userId' is required"
}
}{
"error": {
"code": "unauthorized",
"message": "API key is required"
}
}{
"error": {
"code": "export_not_enabled",
"message": "business is not authorized to use the full delete API"
}
}{
"error": {
"code": "internal_error",
"message": "failed to delete contact"
}
}Full Delete Contact
Permanently delete a contact and suppress its identifiers for GDPR and CCPA erasure requests.
Identify the contact with email, cnvContactId, or userId. At least one is required.
A full delete removes the contact’s personal data and engagement data as described in Data deletion, then suppresses the provided identifiers so the contact is not re-created.
Deletion is permanent and cannot be reversed.
Request access. This endpoint is not enabled by default, contact the Conversion team to request access. Calls from accounts without it return
403 export_not_enabled.
{
"error": {
"code": "missing_identifier",
"message": "one of 'email', 'cnvContactId', or 'userId' is required"
}
}{
"error": {
"code": "unauthorized",
"message": "API key is required"
}
}{
"error": {
"code": "export_not_enabled",
"message": "business is not authorized to use the full delete API"
}
}{
"error": {
"code": "internal_error",
"message": "failed to delete contact"
}
}Authorizations
Your Conversion API key. Found in Settings > Integrations in the dashboard. Format: sk_live_<key_id>_<secret>.
Body
The contact's email address. At least one of email, cnvContactId, or userId is required.
"jane@example.com"
The Conversion contact ID. At least one of email, cnvContactId, or userId is required.
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
The external user identifier for the contact, as passed to the Events endpoints. At least one of email, cnvContactId, or userId is required.
"user_12345"
Response
The contact was deleted and its identifiers suppressed. The response has no body.
Was this page helpful?