List contacts
Lists LinkedIn contacts
Authorizations
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 acts in the user's workspace: one with no workspace yet returns 403 workspace_setup_required, and one in several workspaces returns 403 forbidden (use an API key instead).
Query Parameters
LinkedIn account IDs returned by GET /v1/accounts.
Repeat the query parameter for multiple accounts. The backend also accepts comma-separated values.
If an explicit account target is not accessible to this credential, the API returns 403 account_shared_access_required.
^[1-9][0-9]*$JSON array of filters contacts must all match, in the same shape as a view's filters.
Field keys name their record, such as member.full_name, company.industry, or conversation.reply_state. Custom fields use member.custom_fields.<name>.
To find contacts by LinkedIn URL, filter member.linkedin_url = with a list of URLs.
Requires exactly one account: pass one account_id when several are accessible.