Skip to main content
POST
/
cdp
/
v1
/
users
/
_delete
Delete user profiles
curl --request POST \
  --url https://api.zeotap.com/cdp/v1/users/_delete \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --header 'scopes: <scopes>' \
  --data '
{
  "orgId": 1539,
  "region": "EU",
  "ids": {
    "AdId": [
      "mock_adid_1",
      "mock_adid_2"
    ]
  },
  "sendEmailNotification": false
}
'
{
  "ucids": [
    "<string>"
  ],
  "deletedProfiles": [
    "<string>"
  ],
  "profilesNotFound": [
    "<string>"
  ]
}

Authorizations

​
apikey
string
header
required

Long-lasting client key

Headers

​
scopes
string
required

Comma-separated list of granted scopes. Allowed values: profile.read, profile.write, profile.delete

Example:

"profile.read,profile.write,profile.delete"

​
orgId
integer

Zeotap organisation ID. Required when using Okta JWT authentication.

Example:

1577

Body

application/json
​
orgId
integer
required

Organisation identifier

Example:

1539

​
region
string
required

Region code to scope the deletion

Example:

"EU"

​
ids
object
required

Map containing exactly ONE identifier type with an array of values to delete. Supports up to 400 IDs per API call.

Example:
{
  "AdId": ["ddd682ec-bbe9-4705-bb02-3b9eacaf93bf"]
}
​
sendEmailNotification
boolean
default:false

Whether to trigger an email notification upon deletion.

Response

Profiles deleted successfully

​
ucids
string[]

UCIDs of profiles that were processed

​
deletedProfiles
string[]

UCIDs of profiles successfully deleted

​
profilesNotFound
string[]

UCIDs or IDs that could not be matched to any profile

Last modified on March 30, 2026