Skip to main content
PUT
/
v2
/
api
/
crm
/
people
/
{id}
Update person
curl --request PUT \
  --url https://api.withallo.com/v2/api/crm/people/{id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "job_title": "CTO"
}
'
{
  "data": {
    "id": "per-abc123",
    "name": "John",
    "last_name": "Doe",
    "job_title": "CEO",
    "website": "https://example.com",
    "address": "123 Main St",
    "numbers": [
      "+33612345678"
    ],
    "emails": [
      "[email protected]"
    ],
    "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"
  }
}
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