Property Management - Field Mapping

Field Mapping

Field mapping tells Staffify how to interpret your API's response. Different PMS systems use different field names, so you need to map them to Staffify's standard fields.

How to Map Fields

1Click Fetch Sample Data to load fields from your API
2Detected fields appear in the left column
3Use dropdowns to map each field to a Staffify field
4Click Save Field Mapping

Tenant Fields

Staffify Field	Description	Required?
external_id	Unique ID from your PMS	Yes
name	Full name (or use first_name + last_name)	Yes
phone	Primary phone number	Recommended
email	Email address	Recommended
unit_number	Unit/apartment number	No
rent_amount	Monthly rent	No
lease_start	Lease start date	No
lease_end	Lease end date	No
status	Tenant status (active, former, etc.)	No

Property Fields

Staffify Field	Description	Required?
external_id	Unique ID from your PMS	Yes
address_line1	Street address	Yes
city	City	Recommended
state	State/province	Recommended
postal_code	ZIP/postal code	Recommended
unit_number	Unit number	No
beds	Number of bedrooms	No
baths	Number of bathrooms	No
rent_price	Listed rent price	No
status	Property status	No

Mapping Example

Your API Response:
{
  "resident_id": "R-12345",
  "full_name": "Sarah Johnson",
  "phone_number": "+15551234567",
  "apartment": "204",
  "monthly_rent": 1850
}

Field Mapping:
  resident_id    →  external_id
  full_name      →  name
  phone_number   →  phone
  apartment      →  unit_number
  monthly_rent   →  rent_amount