Create lease

Create a lease for an integration.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
integration_idstringRequired
typeenumOptional

The type associated with the lease

Allowed values:
unit_idstringOptional

The Propexo unique identifier for the unit

start_datedatetime or stringOptional

The start date associated with the lease

first_namestringOptional

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

last_namestringOptional

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

address_1stringOptional

The first address line associated with the resident

citystringOptional

The city associated with the resident

statestringOptional

The state associated with the resident

zipstringOptional

The zip code associated with the resident

country"US"OptionalDefaults to US

The country associated with the resident

financial_account_idstringOptional

The Propexo unique identifier for the financial account

end_datedatetime or stringOptional

The end date associated with the lease

send_welcome_emailbooleanOptionalDefaults to false

Whether to send a welcome email to the tenant

email_1stringOptional

The primary email address associated with the applicant

email_2stringOptional

The secondary email address associated with the resident

phone_1stringOptionalformat: "^\d{10}$"

Primary phone number associated with the applicant

phone_1_typeenumOptional

Type of the primary phone number

Allowed values:
phone_2stringOptionalformat: "^\d{10}$"

Secondary phone number associated with the applicant

phone_2_typeenumOptional

Type of the secondary phone number

Allowed values:
date_of_birthdatetime or stringOptional

The date of birth associated with the applicant

address_2stringOptional

The second address line associated with the resident

address_1_alternatestringOptional

The first alternate address line associated with the resident

address_2_alternatestringOptional

The second alternate address line associated with the resident

city_alternatestringOptional

The alternate city associated with the resident

state_alternatestringOptional

The alternate state associated with the resident

zip_alternatestringOptional

The alternate zip code associated with the resident

country_alternate"US"OptionalDefaults to US

The alternate country associated with the resident

rent_cycleenumOptional

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

rent_amount_in_centsintegerOptional

The rent amount in cents for the lease

rent_due_datedatetime or stringOptional

The rent due date associated with the lease. The timestamp will be stripped off and only the date will be used

property_idstringOptional

The Propexo unique identifier for the property

lease_period_idstringOptional

The Propexo unique identifier for the lease period

floor_plan_idstringOptional

The Propexo unique identifier for the floor plan

scheduled_move_in_datedatetime or stringOptional

The move-in date associated with the lease

primary_contact_idstringOptional

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

tenantslist of objectsOptional

An array of Propexo lead, applicant, or resident IDs. This must also include the primary contact ID

scheduled_move_out_datedatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The scheduled move-out date associated with the lease

statusenumOptional

The status associated with the lease

Allowed values:
resident_idstringOptional

The Propexo unique identifier for the resident

realized_move_in_datedatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The move-in date associated with the lease

realized_move_out_datedatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The move-out date associated with the lease

employee_idstringOptional

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_centsintegerOptional

The NSF fee amount in cents for the lease

associated_resident_idslist of stringsOptional

A list of Propexo Resident IDs associated with the lease

resident_chargeslist of objectsOptional

A list of move in charges for the lease

recurring_resident_chargeslist of objectsOptional

A list of recurring charges for the lease

other_occupantslist of objectsOptional

A list of other occupants for the application

lead_idstringOptional

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

lead_source_idstringOptional

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

third_party_idstringOptional

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

organization_namestringOptional

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

middle_namestringOptional

The middle name associated with the applicant

maiden_namestringOptional

The maiden name associated with the applicant

move_in_datedatetime or stringOptional

The desired move-in date to the unit listed in the application

move_out_datedatetime or stringOptional

The desired move-out date to the unit listed in the application

desired_lease_term_in_monthsstringOptional

The desired lease term in months of the applicant

notesstringOptional

Notes associated with the applicant

is_evictedbooleanOptionalDefaults to false

Whether the applicant has been evicted

is_felonybooleanOptionalDefaults to false

Whether the applicant has a felony

is_criminal_chargebooleanOptionalDefaults to false

Whether the applicant has a criminal charge

eviction_descriptionstringOptional

The description of the eviction

felony_descriptionstringOptional

The description of the felony

criminal_charge_descriptionstringOptional

The description of the criminal charge

marital_statusenumOptional

The marital status of the applicant

Allowed values:
identification_numberstringOptional

The social security number of the applicant

drivers_license_numberstringOptional

The driver’s license number of the applicant

address_historylist of objectsOptional

The address history of the applicant

emergency_contactslist of objectsOptional

A list of emergency contacts for the applicant

employment_historylist of objectsOptional

The employment history of the applicant

other_incomelist of objectsOptional

A list of other income sources for the applicant

vehicleslist of objectsOptional

A list of vehicles for the application

petslist of objectsOptional

A list of applicant pets

concession_feeslist of objectsOptional

A list of concession fees for the application

application_feeslist of objectsOptional

A list of application fees for the application

Response

Successful response

job_idstring

The ID of the job created to handle this operation

dataobject

Errors