Applicants

Create applicant

Create an applicant for an integration.

post/v1/applicants/

Request

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

Request body

integration_idstring required
unit_idstring

The Propexo unique identifier for the unit

first_namestring

The first name associated with the applicant

last_namestring

The last name associated with the applicant

send_rental_application_emailboolean

Whether to send the new applicant an email with a link to the online application form

email_1string

The primary email address associated with the applicant

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' | 'OTHER' | 'WORK'

Type of the secondary phone number

custom_dataV1ApplicantsPostInputCustomData

Deprecated: Field is no longer applicable

property_idstring

The Propexo unique identifier for the property

lease_period_idstring

The lease period to use for the application. If supplied, this field must be one of the approved lease periods defined on the Rentvine template. You can see a list of available choices for each application template on the appropriate lease period endpoint. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements or to change the list of available lease periods

lead_source_idstring

The Propexo unique identifier for the lead source

address_1string

The first address line associated with the applicant

application_status'COMPLETED' | 'APPROVED'

The status associated with the application

citystring

The city associated with the applicant

statestring

The state associated with the applicant

zipstring

The zip code associated with the applicant

address_2string

The second address line associated with the applicant

address_type_idstring

The Propexo unique identifier for the address type

desired_num_bedroomsnumber double

The desired number of bedrooms

desired_num_bathroomsstring

The desired number of bathrooms

desired_lease_term_in_monthsstring

The amount of months for the lease term

number_of_occupantsnumber double

The number of occupants for the applicant

notesstring

Notes associated with the applicant

applicant_status'APPLICANT' | 'CO_APPLICANT' | 'OCCUPANT'

The status of the applicant. This is optional and defaults to ACTIVE.

middle_namestring

The middle name associated with the applicant. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

application_template_idstring

The Propexo unique identifier for the application template. The Rentvine application template dynamically defines which fields are required for each applicant/application: whether a field is active, disabled, required, or optional. A template may also allow some enums to be modified or for entire fields to be relabeled/repurposed. The functionality of a template is extensive and will likely require that you work with your customer to define a custom template for your application use case

leasing_agent_first_namestring

The first name of the leasing agent. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

leasing_agent_last_namestring

The last name of the leasing agent. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

leasing_agent_contact_infostring

The contact info for the leasing agent. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

rent_amount_in_centsinteger

The rent amount in cents that the applicant will pay for the unit. This field is not configurable on the Rentvine template and is always required

security_deposit_in_centsinteger

The security deposit in cents that the applicant will pay for the unit. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

type'APPLICANT' | 'CO_APPLICANT' | 'OCCUPANT' | 'GUARANTOR'

The type of applicant. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements. Although the field itself can be made optional/required, the value must be one of the available choices and cannot be modified as part of the template

marital_status'SINGLE' | 'MARRIED' | 'ENGAGED' | 'SEPARATED' | 'DIVORCED' | 'WIDOWED' | 'UNMARRIED_PARTNERS'

The marital status of the applicant. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements. Although the field itself can be made optional/required, the value must be one of the available choices and cannot be modified as part of the template

maiden_namestring

The maiden name or birth name of the applicant. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

heightstring

The height of the applicant. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

weightstring

The weight of the applicant. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

eye_colorstring

The eye color of the applicant. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

hair_colorstring

The hair color of the applicant. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

phone_3string

Third phone number associated with the applicant. An applicant can have no more than one of each phone type. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

phone_3_type'HOME' | 'WORK' | 'MOBILE'

Type of the third phone number. An applicant can have no more than one of each phone type.

identification_numberstring

The Social Security Number or Individual Taxpayer Identification Number associated with the applicant. Rentvine uses a pre-2011 validation scheme for SSN's meaning that some valid SSNs will be incorrectly rejected. Reach out to support if you find that a valid SSN is being rejected. This field is not configurable on the Rentvine template and is always required

citizenshipstring

The country of citizenship of the applicant. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

place_of_birthstring

The place of birth of the applicant. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

passport_numberstring

The passport number of the applicant. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

student_idstring

The student ID number of the applicant. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

drivers_license_numberstring

The driver's license number of the applicant. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

drivers_license_statestring

The issuing state of the applicant's driver's license. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

lead_sourcestring

The name of the source of the lead or how the applicant heard of the property management company. Depending on the Rentvine template, this field can be customized to be either required or optional. You will need to work with your customer directly to configure this field to your application requirements

application_idstring

Optionally, the Propexo unique identifier for the application onto which you'd like to add this applicant. If omitted, Rentvine will create a new application for this applicant.

lead_idstring

The Propexo unique identifier for the lead

status'PENDING' | 'APPROVED' | 'CANCELED' | 'DENIED' | 'SIGNED'

The status associated with the application

rent_amount_market_in_centsinteger

The market rent amount in cents for the lease

employee_idstring

The Propexo unique identifier for the employee

third_party_idstring

A unique value provided to the PMS to uniquely identify the applicant from your system.

organization_namestring

The name of your organization. Yardi uses this for associating a applicant

Response

Successful response

job_idstring required

The ID of the job created to handle this operation

dataV1ApplicantsPostOutputData required

Changes

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