Delete a Contact

Deletes a contact from your audience.

POSThttps://api.audienceful.com/v2/people/delete

curl --location --request POST 'https://api.audienceful.com/v2/people/delete' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <your-api-key>' \
--data-raw '{
    "email": "person@example.com"
}'

204 No Content

Requires the people:write scope.

Address the contact in the request body, with either their id or their email. Deleting a contact removes them and their event history permanently — there is no undo, and re-adding the same email address creates a new contact with no history.

Body

idstring

The contact's opaque id. Takes precedence over email when both are supplied.

emailstring

The contact's email address (case-insensitive). Use this when you don't hold their id.

One of id or email is required; supplying neither returns a 400. An identifier that doesn't match a contact returns a 404.

Also available: `DELETE /v2/people/{id}`

The path form still works and is not deprecated:

Bash

curl --location --request DELETE 'https://api.audienceful.com/v2/people/jQKdwqp3YRRtTrwqUJEp7d' \
  --header 'X-Api-Key: <your-api-key>'

Response

Returns 204 No Content with an empty body.

Body

Also available: DELETE /v2/people/{id}

Response

Also available: `DELETE /v2/people/{id}`