Leases

Create lease

Create a lease for an integration.

post/v1/leases/

Request

  • Base URL: https://api.propexo.com
  • URL: https://api.propexo.com/v1/leases/
  • Auth: HTTP bearer

Request body

integration_idstring required
type'Fixed' | 'FixedWithRollover' | 'AtWill'

The type associated with the lease

unit_idstring

The Propexo unique identifier for the unit

first_namestring

The first name associated with the applicant. Required if lead_id is not specified

last_namestring

The last name associated with the applicant. Required if lead_id is not specified

address_1string

The first address line associated with the resident

citystring

The city associated with the resident

statestring

The state associated with the resident

zipstring

The zip code associated with the resident

country'US'

The country associated with the resident

financial_account_idstring

The Propexo unique identifier for the financial account

send_welcome_emailboolean

Whether to send a welcome email to the tenant

email_1string email

The primary email address associated with the applicant

email_2string email

The secondary email address associated with the resident

phone_1string

Primary phone number associated with the applicant

phone_1_type'FAX' | 'HOME' | 'MOBILE' | 'WORK'

Type of the primary phone number

phone_2string

Secondary phone number associated with the applicant

phone_2_type'FAX' | 'HOME' | 'MOBILE' | 'WORK'

Type of the secondary phone number

address_2string

The second address line associated with the resident

address_1_alternatestring

The first alternate address line associated with the resident

address_2_alternatestring

The second alternate address line associated with the resident

city_alternatestring

The alternate city associated with the resident

state_alternatestring

The alternate state associated with the resident

zip_alternatestring

The alternate zip code associated with the resident

country_alternate'US'

The alternate country associated with the resident

rent_cycle'Monthly' | 'Weekly' | 'Every2Weeks' | 'Quarterly' | 'Yearly' | 'Every2Months' | 'Daily' | 'Every6Months' | 'OneTime'

The duration in which rent charges will be automatically appended to the lease ledger

rent_amount_in_centsinteger

The rent amount in cents for the lease

property_idstring

The Propexo unique identifier for the property

lease_period_idstring

The Propexo unique identifier for the lease period

floor_plan_idstring

The Propexo unique identifier for the floor plan

primary_contact_idstring

The Propexo unique identifier of the primary contact. This must either be a lead, applicant, or resident in Propexo

scheduled_move_out_datestring date-time

The scheduled move-out date associated with the lease

status'PENDING' | 'ACTIVE'

The status associated with the lease

resident_idstring

The Propexo unique identifier for the resident

realized_move_in_datestring date-time

The move-in date associated with the lease

realized_move_out_datestring date-time

The move-out date associated with the lease

employee_idstring

The Propexo unique identifier for the employee. Employee must have a role of LEASING_AGENT. Required if lead_id is not specified

nsf_fee_amount_in_centsinteger

The NSF fee amount in cents for the lease

associated_resident_idsstring[]

A list of Propexo Resident IDs associated with the lease. The resident must be a primary.

lead_idstring

The Propexo unique identifier for the lead. The lead will be converted to an applicant

lead_source_idstring

The Propexo unique identifier for the lead source. Required if lead_id is not specified

third_party_idstring

A unique ID you would like to associate with the applicant. This is not the Yardi applicant ID. Required if lead_id is not specified

organization_namestring

The name of your organization. Yardi uses this for associating an applicant. Required if lead_id is not specified

middle_namestring

The middle name associated with the applicant

maiden_namestring

The maiden name associated with the applicant

desired_lease_term_in_monthsstring

The desired lease term in months of the applicant

notesstring

Notes associated with the applicant

is_evictedboolean

Whether the applicant has been evicted

is_felonyboolean

Whether the applicant has a felony

is_criminal_chargeboolean

Whether the applicant has a criminal charge

eviction_descriptionstring

The description of the eviction

felony_descriptionstring

The description of the felony

criminal_charge_descriptionstring

The description of the criminal charge

marital_status'SINGLE' | 'MARRIED'

The marital status of the applicant

identification_numberstring

The social security number of the applicant

drivers_license_numberstring

The driver's license number of the applicant

Response

Successful response

job_idstring required

The ID of the job created to handle this operation

dataV1LeasesPostOutputData required

Changes

No recorded changes to this operation across all 1 revision of this API.