Person

A human being: a customer, a contact, an employee, or an end user of the product.

Fields

Field	Type	Req	Notes
`name`	Name	yes
`emails`	ContactPoint[]	no
`phones`	ContactPoint[]	no	label mobile, home, fax, work or other
`urls`	ContactPoint[]	no	websites and social profiles; the URL identifies the network
`addresses`	Address[]	no
`job_title`	string	no
`affiliations`	Affiliation[]	no	Organizations this person belongs to, with role, primary flag and period
`avatar`	Ref<File>	no
`birthday`	date	no	confidential
`locale`	string	no	BCP 47; the OIDC locale claim
`timezone`	string	no	IANA zone; the OIDC zoneinfo claim
`description`	text	no

Extension	Type	Notes
`ext.crm.lifecycle_stage`	enum(subscriber\|lead\|marketing_qualified_lead\|sales_qualified_lead\|opportunity\|customer\|evangelist\|other)	Where this person stands in the marketing and sales lifecycle, from subscriber to evangelist (the HubSpot stages, snake_case). A lead is a Person with lifecycle_stage lead; there is no Lead model.
`ext.crm.source`	string	Where this person came from: the channel or campaign that produced the contact (organic search, referral, event, paid social).