For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
How It WorksKnowledge BaseOnboardingVideo TutorialsPMS GuidanceAPI ReferenceRelease Notes
    • Overview
    • PMS Generic APIs
        • GETGet all leads
        • POSTCreate lead
        • GETGet a lead by ID
        • PUTUpdate lead
        • GETGet all lead relationships
        • GETGet all lead sources
        • GETGet lead source by ID
        • GETGet rentable items for a lead
    • CRM Generic APIs
    • PMS APIs
    • CRM APIs
    • Download OpenAPI Spec
Dashboard
LogoLogo
PMS Generic APIsLeads

Update lead

PUT
/v1/leads/:id
PUT
/v1/leads/:id
$curl -X PUT https://api.propexo.com/v1/leads/id \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{}'
1{
2  "job_id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
3  "data": {}
4}
Update a lead.
Was this page helpful?
Previous

Get all lead relationships

Next
Built with

Authentication

AuthorizationBearer

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

Path parameters

idstringRequired
The ID of the resource.

Request

This endpoint expects an object.
lead_idstringOptional
The Propexo unique identifier for 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
unit_idstringOptional
The Propexo unique identifier for the unit
first_namestringOptional
The first name associated with the lead
last_namestringOptional
The last name associated with the lead
number_of_additional_occupantsintegerOptional>=0
The number of additional occupants associated with the lead
desired_num_bathroomsdoubleOptional>=0
The desired number of bathrooms
desired_num_bedroomsdoubleOptional
The desired number of bedrooms
credit_scorestringOptional
The credit score of the lead
target_move_in_datestringOptional

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

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_centsdoubleOptional>=0
The maximum rent cost the lead is looking to pay, in cents
monthly_income_in_centsintegerOptional>=0
The monthly income of the lead, in cents
middle_initialstringOptional=1 character
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
The status associated with the lead
Allowed values:
inactive_reasonenumOptional
The reason the lead is inactive
lease_period_idstringOptional
The Propexo unique identifier for the lease period
lead_source_idstringOptional
The Propexo unique identifier for the lead source
middle_namestringOptional
The middle name associated with the lead
phone_1_typeenumOptional
Type of the primary phone number
Allowed values:
phone_2stringOptional
Secondary phone number associated with the lead
phone_2_typeenumOptional
Type of the secondary phone number
Allowed values:
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
desired_min_rent_in_centsdouble or nullOptional
The minimum rent cost the lead is looking to pay, in cents
number_of_occupantsdoubleOptional
The number of occupants living in the unit
notesstringOptional
Notes associated with the lead
address_type_idstringOptional
The Propexo unique identifier for the address type. This is required when updating the address
desired_lease_term_in_monthsstringOptional
The amount of months for the lease term
applicant_statusenumOptional
The status of the lead. This is optional and defaults to ACTIVE.
Allowed values:
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_birthstringOptional
The date of birth associated with the lead
floor_plan_idstringOptional
The Propexo unique identifier for the floor plan
desired_move_in_datestringOptionalDeprecated

Deprecated. Use target_move_in_date instead.

desired_bathroomsstringOptionalDeprecated

Deprecated. Use desired_num_bathrooms instead.

desired_bedroomsintegerOptional>=0Deprecated

Deprecated. Use desired_num_bedrooms instead.

eventslist of objectsOptionalDeprecated

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

Response

Successful response
job_idstring
The ID of the job created to handle this operation
dataobject

Errors

400
Bad Request Error