Skip to main content
PATCH
Update contact

Path Parameters

contactId
string
required
Pattern: ^[0-9a-z]+$

Body

application/json

Omitted fields are left unchanged, and null clears a nullable field.

status
string | null

A status, by ID or by name. Names match ignoring case and accents. When a value is one status's ID and another's name, the ID wins.

notes
string | null
valuation
number | null
assigneeId
string | null

The default assignee of this contact's threads that have none of their own.

Pattern: ^[0-9a-z]+$

Response

The team's record of a person: their profiles, plus the team's CRM state about them.

The team's record of a person: their profiles, plus the team's CRM state about them.

id
string
required
profiles
object[]
required

The person's profiles, oldest link first. Profiles on platforms unavailable to the team are left out.

statusId
string | null
required

A status: a pipeline stage on the team's board.

tagIds
string[]
required

A tag: a label the team puts on contacts.

notes
string | null
required
valuation
required

What the person is worth to the team, in the team's currency.

assigneeId
string | null
required

The default assignee of this contact's threads that have none of their own.

createdAt
string<date-time>
required
Example:

"2026-09-14T10:32:00.000Z"

updatedAt
string<date-time>
required
Example:

"2026-09-14T10:32:00.000Z"

status
object

A pipeline stage on the team's board. A contact has at most one status.

tags
object[]
assignee
object

A person on the team, who can be assigned threads and contacts.