contacts.delete

Delete a contact and every interaction with them

Request: DELETE/api/v1/contacts/{contactId}
Scope required: contacts:write
Effect: Deletes something. Confirm with a person before calling it.
Acts on: Acts on the account’s own job search.
MCP tool: contacts_delete
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Deletes a contact together with the whole history of interactions logged against them. This cannot be undone, and the companies and applications they were linked to are left untouched. A contact belonging to another account answers 404. Answers 204 with no body. Read what is about to be lost first with `contacts.get`.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
contactId	path	Required	string
If-Match	header	Optional	string — The ETag of the version you read. The write is refused with 412 if the resource has changed since.

Response

Answers 204 with no body.

Examples

Forget a contact who has moved on

Forget a contact who has moved on — request

curl -s -X DELETE https://www.jobapplicationtracking.com/api/v1/contacts/ct_42 \
  -H "Authorization: Bearer $JAT_KEY"

Forget a contact who has moved on — response

null