v1

latestOpenAPI 3.0.32026-07-264955102.7 KB

CRM

Update person

Updates an existing person. Only provided fields will be updated.

put/v2/api/crm/people/{id}

Path parameters

idstring required

Example:per-abc123

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

Request body

namestring nullable

First name

last_namestring nullable

Last name

job_titlestring nullable

Job title

websitestring nullable

Website URL

addressstring nullable

Postal address

numbersstring[] nullable

Phone numbers (replaces all existing numbers)

emailsstring[] nullable

Email addresses (replaces all existing emails)

company_idstring nullable

ID of the company to associate with

Response

Person updated

Example response

{
  "data": {
    "id": "per-abc123",
    "name": "John",
    "last_name": "Doe",
    "job_title": "CEO",
    "website": "https://example.com",
    "address": "123 Main St",
    "numbers": [
      "+33612345678"
    ],
    "emails": [
      "john@example.com"
    ],
    "company": {
      "id": "com-xyz789",
      "name": "Acme Corp"
    },
    "interactions": 5,
    "last_activity_at": "2026-04-28T10:30:00",
    "created_at": "2026-04-01T09:00:00",
    "updated_at": "2026-04-28T10:30:00"
  }
}