Skip to main content
POST
Privacy delete people from Audiences

Authorizations

clay-api-key
string
header
required

Personal API key tied to your Clay user. Create one under Settings → Account in the Clay app.

Body

application/json

Body

Identifies people to delete within the workspace associated with your API key.

person_identifiers
object[]
required

Provide 1–100 email, LinkedIn slug, or phone identifiers. People matching any identifier are selected.

Required array length: 1 - 100 elements
dry_run
boolean
default:false

Preview the number of matching people without queueing deletion. Defaults to false.

Response

Returns HTTP 200 for a dry-run preview or when no people match.

Returns HTTP 200 for a dry-run preview or when no people match.

matched_count
integer
required

The number of unique matching people, including archived people. No deletion was queued.

Required range: 0 <= x <= 9007199254740991
status
string
required
Allowed value: "dry_run"