Skip to main content
PUT
Update person
Required scope: CRM_WRITE

Partial update

This endpoint performs a partial update — only the fields you include in the request body are modified. Omitted fields are left unchanged. All fields from the create endpoint are accepted and optional.

Unlinking a company

Send company_id as an empty string ("") to remove the person’s association with their current company.

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

Person ID (e.g., "per-abc123")

Example:

"per-abc123"

Body

application/json

Request body for updating a person. Only provided fields will be updated.

name
string | null

First name

last_name
string | null

Last name

job_title
string | null

Job title

website
string | null

Website URL

address
string | null

Postal address

numbers
string[] | null

Phone numbers (replaces all existing numbers)

emails
string[] | null

Email addresses (replaces all existing emails)

company_id
string | null

ID of the company to associate with

Response

Person updated

data
object

A person in the CRM