Skip to main content
PATCH
Update Person
:id may be an entity UUID, email, domain, or LinkedIn URL. Identifier fields on the body attach to the entity. Every other field is asserted as a claim.

Body

Any subset of identifier fields (email, linkedin_url, linkedin_member_id, hubspot_id, pipedrive_id, apollo_id, attio_id) plus any claim fields (first_name, last_name, job_title, company, seniority, department, city, country, phone, pipeline_stage, etc.). To clear a claim, pass null for its value. The claim is invalidated rather than deleted, so prior values remain auditable.

Response

Both id and entity_id are returned and always carry the same value (the entity UUID). GET /v2/people returns only id.

The write model in one line

Observations record what happened. Assertions through POST and PATCH declare what is true now. Both land in the same context graph, both show up in /v2/accounts/:id, and asserted facts stick until you change them.