# Update person

> Updates an existing person. Only provided fields will be updated. Set custom attribute values with custom attributes . A key that is not an active custom…

`PUT /v2/api/crm/people/{id}`

<Note>
**Required scope:** `CRM_WRITE`
</Note>

## 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.

`custom_attributes` is accepted too. Only the keys you send change.

## Unlinking a company

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

## Custom attributes

`custom_attributes` sets the values of your [custom fields](/docs/crm/create-attribute). Create the field first, then use its `key` here.

| Attribute type | Accepted value |
|----------------|----------------|
| `TEXT` | A string |
| `NUMBER` | A finite JSON number. Strings are rejected. Read back as a decimal, so `180` is returned as `180.0` |
| `BOOLEAN` | A JSON boolean |
| `DATE` | `YYYY-MM-DD` or an ISO datetime. Stored as a date and returned as `YYYY-MM-DD` |
| `DROPDOWN` | An option key or label, case-insensitive. Always returned as the option key |

- Send `null` for a key to clear its value.
- Keys you leave out are not changed. `{}`, or leaving out `custom_attributes`, changes nothing.
- An unknown or archived key returns `400 CUSTOM_ATTRIBUTE_KEY_UNKNOWN`. A value of the wrong type returns `400 CUSTOM_ATTRIBUTE_VALUE_INVALID`. In both cases `param` is `custom_attributes.<key>`.
- The whole request is validated before anything is written, so a rejected request changes nothing.
- The response always includes `custom_attributes`, `{}` when the person has none. Archived attributes and empty values are left out.
- Values are also synced to your connected CRMs that create contacts. A value on an attribute that is synced from a CRM can be overwritten by the next CRM sync.

### Example

This sets `lead_source` and clears `budget`. Any other custom attribute is untouched.

```json
{
  "custom_attributes": {
    "lead_source": "Referral",
    "budget": null
  }
}
```

```json
{
  "data": {
    "id": "per-abc123",
    "name": "John",
    "custom_attributes": {
      "lead_source": "Referral"
    }
  }
}
```
