Skip to main content

The Tenancy Person object

idstringrequired
typestringrequired

Possible values: [tenancy_people]

attributes required
namestring

The full name of the person. This is read-only and derived from other fields.

Example: Sam Olsen
titlestring

The person's title (e.g., Mr, Mrs, Miss, Ms, Dr).

Example: Ms
first_namestring

The person's first name.

Example: Sam
middle_namestringnullable

The person's middle name, if applicable.

Example: Alex
last_namestring

The person's last name.

Example: Olson
residently_mailemail

The person's Residently email address

Example: sam.olsen.1n4@residentlymail.com
emailemail

The person's personal email address.

Example: sam.olsen@example.com
mobilestring

The person's mobile phone number.

Example: +447700900123
date_of_birthdate

The person's date of birth (ISO 8601 format: YYYY-MM-DD).

Example: 1990-05-15
rolestring

The person's role in the system.

Possible values: [resident, occupier, guarantor]

Example: resident
provider_idstringnullable

An external provider reference associated with the person, if applicable.

Example: abc123
metadataobject

Additional metadata for the tenancy person

Example: {"field_1":"value1","field_2":"value2"}
created_atdate-time
updated_atdate-time
The Tenancy Person object
{
"id": "string",
"type": "tenancy_people",
"attributes": {
"name": "Sam Olsen",
"title": "Ms",
"first_name": "Sam",
"middle_name": "Alex",
"last_name": "Olson",
"residently_mail": "sam.olsen.1n4@residentlymail.com",
"email": "sam.olsen@example.com",
"mobile": "+447700900123",
"date_of_birth": "1990-05-15",
"role": "resident",
"provider_id": "abc123",
"metadata": {
"field_1": "value1",
"field_2": "value2"
},
"created_at": "2024-07-29T15:51:28.071Z",
"updated_at": "2024-07-29T15:51:28.071Z"
}
}