Skip to main content
POST
Delete contacts

Authorizations

Authorization
string
header
required

Pass Authorization: Bearer <credential>, where the credential is either:

  • an API key (sk_…), generated by an organization admin in Settings, for scripts and automation;
  • an access token from tth auth login (the TalkToHumans CLI), which any member of the workspace can use.

Both resolve to the same organization and user. A login token whose sign-in has no workspace yet returns 403 workspace_setup_required.

Body

application/json
account_id
string
required

LinkedIn account ID returned by GET /v1/accounts.

Pattern: ^[1-9][0-9]*$
contact_ids
string[]
required

Contact IDs returned by GET /v1/contacts. Duplicates are deleted once.

Required array length: 1 - 500 elements
Pattern: ^[1-9][0-9]*$

Response

Contacts deleted. Contacts that can't be deleted are listed in skipped.

data
object
required