Change a person
Send only what changes. roles and preferred_contact are replaced whole. address and custom_fields are merged: parts you leave out are kept, and a part sent as null is removed. Changing email or phone changes the person’s primary email or phone too; it does not change the email anybody signs in with. display_name cannot be sent: it is built from the name parts. A required custom field is checked only when you send it. Needs write on People.
Authorizations
Body
Values for the custom fields, keyed by field key (see List custom fields). A key that is not a field is refused, and each value must suit its field: text; long text of 5,000 characters at most; a number; true or false; a date; one of a select's options; a list of a multi-select's options; a phone number; an email address; a web address starting http:// or https://; { "country": "US", "state": "ME" } for a country and state; an ID for an organization or person field; a list of volunteer role keys. null clears a value.
Response
The person, as they now are.
Values for the custom fields, keyed by field key (see List custom fields). A key that is not a field is refused, and each value must suit its field: text; long text of 5,000 characters at most; a number; true or false; a date; one of a select's options; a list of a multi-select's options; a phone number; an email address; a web address starting http:// or https://; { "country": "US", "state": "ME" } for a country and state; an ID for an organization or person field; a list of volunteer role keys. null clears a value.

