Create lead

POST
/v1/leads/

Create a lead for an integration.

Request

This endpoint expects an object.
integration_idstringRequired
property_idstringOptional

The Propexo unique identifier for the property

first_namestringOptional

The first name associated with the lead

last_namestringOptional

The last name associated with the lead

employee_idstringOptional

The Propexo unique identifier for the employee

desired_unit_idslist of stringsOptional

An array of the Propexo unit IDs that the lead is interested in

number_of_additional_occupantsintegerOptional

The number of additional occupants associated with the lead

desired_bathroomsstringOptional

The desired number of bathrooms

desired_bedroomsintegerOptional

The desired number of bedrooms

credit_scorestringOptional

The credit score of the lead

desired_move_in_datedatetime or stringOptional

The desired move in date of the lead

email_1stringOptional

The primary email address associated with the lead

has_catsbooleanOptional

Whether or not the lead has cats

has_dogsbooleanOptional

Whether or not the lead has dogs

has_other_petsbooleanOptional

Whether or not the lead has pets that aren’t dogs or cats

desired_max_rent_in_centsintegerOptional

The maximum rent cost the lead is looking to pay, in cents

monthly_income_in_centsintegerOptional

The monthly income of the lead, in cents

middle_initialstringOptional

The middle initial of the lead

phone_1stringOptional

Primary phone number associated with the lead

lead_sourcestringOptional

The name of the source of the lead

statusenumOptional
Allowed values: ACTIVECOLDINACTIVEWAITLISTED

The status associated with the lead

lead_source_idstringOptional

The Propexo unique identifier for the lead source

unit_idstringOptional

The Propexo unique identifier for the unit

lease_period_idstringOptional

The Propexo unique identifier for the lease period

phone_1_typeenumOptional
Allowed values: FAXHOMEMOBILEWORK

Type of the primary phone number

middle_namestringOptional

The middle name associated with the lead

phone_2stringOptional

Secondary phone number associated with the lead

phone_2_typeenumOptional
Allowed values: FAXHOMEMOBILEWORK

Type of the secondary phone number

address_1stringOptional

The first address line associated with the lead

address_2stringOptional

The second address line associated with the lead

citystringOptional

The city associated with the lead

statestringOptional

The state associated with the lead

zipstringOptional

The zip code associated with the lead

target_move_in_datedatetime or stringOptional

The move-in date associated with the lead. The timestamp will be stripped off and only the date will be used

desired_min_rent_in_centsdoubleOptional

The minimum rent cost the lead is looking to pay, in cents

desired_num_bathroomsdoubleOptional

The desired number of bathrooms

desired_num_bedroomsdoubleOptional

The desired number of bedrooms

number_of_occupantsintegerOptional

The number of occupants living in the unit

notesstringOptional

Notes associated with the lead

eventslist of objectsOptional

DEPRECATED: Please use /events endpoints to write events. Array of events associated with this lead

countrystringOptional

The country associated with the lead

status_rawstringOptional

The raw status associated with the lead

desired_unit_typestringOptional

The desired type of unit

lead_relationship_idstringOptional

The Propexo unique identifier for the lead relationship

date_of_birthdatetime or stringOptional

The date of birth associated with the lead

desired_lease_term_in_monthsstringOptional

The amount of months for the lease term

organization_namestringOptional

The name of your organization. Sample1 uses this for associating a prospect

third_party_idstringOptional

Any unique ID you would like to associate with a lead.

Response

This endpoint returns an object.
job_idstring

The ID of the job created to handle this operation

dataobject

Errors