Person
A Person represents a human being to which the logged in user has a business relationship. It is a type of Contact, and may be related to a User Account (via a Role) or Organizational Unit via a Contact Assignment.
A Person implements the Contact interface.
OBJECT SCHEMA
| Field | Type | Required | Description |
|---|---|---|---|
id | UUID | Yes | The unique ID of this object. |
externalUserId | string | No | The user ID from the originating system or website. |
displayName | string | No | The displayName of this person, usually the given + family names. |
givenName | string | No | The first (given) name of the Person. |
familyName | string | No | The last (family) name of the Person. |
description | string | No | Assignee-provided description. |
primaryEmail | No | The primary email for this Person. | |
emails | Email[] | No | All emails related to this Person. |
primaryTelephone | Telephone | No | The primary telephone for this Person |
telephone | Telephone[] | No | All telephones related to this Person. |
notes | Note[] | No | Any notes entered by the Assignee. |
addresses | Address[] | No | Any addresses entered by the Assignee. |
typename | string | Yes | The GraphQL type name. Aways "Person". |
* indicates a required field
Updated July 23, 2026