Delete a person everywhere by key
Deletes a Person by your own key, for privacy-deletion requests. Pass externalId or email. GainTrace removes the Person’s records at every Company, archived ones included, and fires contact.deleted for each. It is idempotent: if nobody matches, the response is still 204.
This is the same operation as DELETE /people. Their survey data is erased too: answers to your surveys are anonymized (name, email and free text removed, scores and choices kept), imported answers are deleted, and their short personal survey links are deleted.
Scope: write:contacts
Authorizations
Bearer API key. Secret server keys start with gt_live_; client-safe browser keys start with gt_pub_ (write-only, origin-pinned). Create and scope keys in Settings → API Keys.
Query Parameters
Your own stable id for the Person (for example a Segment userId). Exact match.
Used when externalId is absent.
Response
Deleted, or nobody matched.