Skip to main content
GET
Get a contact

Authorizations

Authorization
string
header
required

An API key (utk_live_...) or an app's OAuth access token (uto_...).

Path Parameters

contactId
string<uuid>
required

A contact id.

Response

The contact.

id
string<uuid>
required
email
string<email>
required

The address, lowercased. It never changes.

name
string | null
required
attributes
object
required

Text details, each a name of up to 64 characters and a text value of up to 500; {} when there are none.

externalId
string | null
required

Your own user id for the person (what identify sends); unique in the organization.

source
string | null
required

What made the contact when no person added it: identify (a verified identity with an email) or hubspot (a HubSpot workflow action). Null for one added in Usertick, by import or through the API.

unsubscribedAt
string<date-time> | null
required

When the contact unsubscribed (or was unsubscribed); null while subscribed. A contact is never subscribed again.

Example:

"2026-09-30T10:00:00.000Z"

listIds
string<uuid>[]
required

The lists the contact is on.

createdAt
string<date-time>
required
Example:

"2026-09-30T10:00:00.000Z"

updatedAt
string<date-time> | null
required
Example:

"2026-09-30T10:00:00.000Z"

Last modified on November 8, 2026