Skip to navigation

Update a person

Beta
View as MarkdownOpen in Claude

Applies a partial update to a person. Send only the fields you want to change.

A person’s job title belongs to their business link, not the person. Sending title in any form, including null, returns a 400 with the message title moved to the business relationship; update it with PATCH /api/v2/businesses/{businessReference}/people/{personReference}.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

personReferencestringRequired
The person reference.

Request

This endpoint expects an object.
firstNamestringOptional
The person's first name.
middleNamestringOptional
The person's middle name.
lastNamestringOptional
The person's last name.
primaryEmailstringOptional
The person's primary email address.
secondaryEmailstringOptional
The person's secondary email address.
primaryPhoneNumberstringOptional
The person's primary phone number.
secondaryPhoneNumberstringOptional
The person's secondary phone number.
nationalitystringOptional

The person’s nationality, as a two-letter ISO 3166-1 alpha-2 country code. Nationality selects which identity number applies — US uses ssn, and any other value uses nationalIdNumber and nationalIdIssuer.

nationalIdIssuerstringOptional

The authority that issued the national ID, used when nationality is not US.

driversLicenseNumberstringOptional
The person's driver's license number.
driversLicenseStatestringOptional

The two-letter state code for the driver’s license.

externalIdstringOptional
Your own identifier for the person.
customDatamap from strings to anyOptional

Key-value data to merge into the person’s stored customData. Payabli stores an owner’s answers to a boarding template’s custom questions under the templateAnswers key.

When you update a person, Payabli merges customData into the stored value, following JSON Merge Patch (RFC 7396). Keys you don’t send are kept at every depth, and nested objects merge key by key. Strings, numbers, Boolean values, and arrays replace the stored value, and arrays aren’t merged. Send a key as null to delete it, such as {"crmId": null}. A customData that isn’t an object, such as an array, replaces the stored value whole. Leave out customData to keep it as is.

The customData you send can be up to 65,536 bytes serialized. The limit applies to the request, not to the merged result.

addresseslist of objectsOptional
Postal addresses associated with the person.
identificationDocumentslist of objectsOptional

Government-issued identification documents for the person.

Response

Person updated.
successboolean
Whether the request succeeded.
messagestring or null

A human-readable result message.

traceIdstring or null
The trace identifier for the request, useful for support.
dataobject or null
The updated person.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
500
Internal Server Error