Other Operations

Update Property Info

Attach a property (or mailing address) to the specified lead. The behaviour depends on the property.id field in the request body:

id omitted or <= 0 — the service first tries to merge with an existing property on the lead that has the same street/city/state/zip; if no match is found, a new property record is created.
id > 0 — the named property is updated in place. The property must belong to this lead (its leadUserId must match the lead’s); otherwise the request is rejected with 200108 LEAD_PROPERTY_NOT_EXIST.

Validation:

At least one of city, state, zipCode, streetAddress must be non-blank; otherwise 200057 PROPERTY_ADDRESS_EMPTY is returned.
Caller must have manage permission on the lead.

POST

v1.0

leads

{leadId}

property

Update Property Info

curl --request POST \
  --url https://api.lofty.com/v1.0/leads/{leadId}/property \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "price": 100000,
  "state": "California",
  "city": "New York",
  "streetAddress": "22348 Regnart RD",
  "zipCode": "25401",
  "county": "<string>",
  "propertyType": "Single Family Home",
  "bedrooms": 3,
  "bathrooms": 2,
  "squareFeet": 100,
  "lotSize": 26.33,
  "parkingSpace": 1,
  "floors": 1,
  "mailAddress": true,
  "id": 123,
  "leadUserId": 123,
  "listingId": "<string>",
  "autoListingId": 123,
  "label": "<string>",
  "note": "<string>",
  "listingStatus": "<string>",
  "labelList": "<string>",
  "pictureUrl": "<string>",
  "siteListingUrl": "<string>",
  "labelType": "<string>",
  "priceMax": 10000000,
  "priceMin": 100000
}
'

import requests

url = "https://api.lofty.com/v1.0/leads/{leadId}/property"

payload = {
    "price": 100000,
    "state": "California",
    "city": "New York",
    "streetAddress": "22348 Regnart RD",
    "zipCode": "25401",
    "county": "<string>",
    "propertyType": "Single Family Home",
    "bedrooms": 3,
    "bathrooms": 2,
    "squareFeet": 100,
    "lotSize": 26.33,
    "parkingSpace": 1,
    "floors": 1,
    "mailAddress": True,
    "id": 123,
    "leadUserId": 123,
    "listingId": "<string>",
    "autoListingId": 123,
    "label": "<string>",
    "note": "<string>",
    "listingStatus": "<string>",
    "labelList": "<string>",
    "pictureUrl": "<string>",
    "siteListingUrl": "<string>",
    "labelType": "<string>",
    "priceMax": 10000000,
    "priceMin": 100000
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({
    price: 100000,
    state: 'California',
    city: 'New York',
    streetAddress: '22348 Regnart RD',
    zipCode: '25401',
    county: '<string>',
    propertyType: 'Single Family Home',
    bedrooms: 3,
    bathrooms: 2,
    squareFeet: 100,
    lotSize: 26.33,
    parkingSpace: 1,
    floors: 1,
    mailAddress: true,
    id: 123,
    leadUserId: 123,
    listingId: '<string>',
    autoListingId: 123,
    label: '<string>',
    note: '<string>',
    listingStatus: '<string>',
    labelList: '<string>',
    pictureUrl: '<string>',
    siteListingUrl: '<string>',
    labelType: '<string>',
    priceMax: 10000000,
    priceMin: 100000
  })
};

fetch('https://api.lofty.com/v1.0/leads/{leadId}/property', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lofty.com/v1.0/leads/{leadId}/property",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'price' => 100000,
    'state' => 'California',
    'city' => 'New York',
    'streetAddress' => '22348 Regnart RD',
    'zipCode' => '25401',
    'county' => '<string>',
    'propertyType' => 'Single Family Home',
    'bedrooms' => 3,
    'bathrooms' => 2,
    'squareFeet' => 100,
    'lotSize' => 26.33,
    'parkingSpace' => 1,
    'floors' => 1,
    'mailAddress' => true,
    'id' => 123,
    'leadUserId' => 123,
    'listingId' => '<string>',
    'autoListingId' => 123,
    'label' => '<string>',
    'note' => '<string>',
    'listingStatus' => '<string>',
    'labelList' => '<string>',
    'pictureUrl' => '<string>',
    'siteListingUrl' => '<string>',
    'labelType' => '<string>',
    'priceMax' => 10000000,
    'priceMin' => 100000
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: <content-type>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lofty.com/v1.0/leads/{leadId}/property"

	payload := strings.NewReader("{\n  \"price\": 100000,\n  \"state\": \"California\",\n  \"city\": \"New York\",\n  \"streetAddress\": \"22348 Regnart RD\",\n  \"zipCode\": \"25401\",\n  \"county\": \"<string>\",\n  \"propertyType\": \"Single Family Home\",\n  \"bedrooms\": 3,\n  \"bathrooms\": 2,\n  \"squareFeet\": 100,\n  \"lotSize\": 26.33,\n  \"parkingSpace\": 1,\n  \"floors\": 1,\n  \"mailAddress\": true,\n  \"id\": 123,\n  \"leadUserId\": 123,\n  \"listingId\": \"<string>\",\n  \"autoListingId\": 123,\n  \"label\": \"<string>\",\n  \"note\": \"<string>\",\n  \"listingStatus\": \"<string>\",\n  \"labelList\": \"<string>\",\n  \"pictureUrl\": \"<string>\",\n  \"siteListingUrl\": \"<string>\",\n  \"labelType\": \"<string>\",\n  \"priceMax\": 10000000,\n  \"priceMin\": 100000\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.lofty.com/v1.0/leads/{leadId}/property")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "<content-type>")
  .body("{\n  \"price\": 100000,\n  \"state\": \"California\",\n  \"city\": \"New York\",\n  \"streetAddress\": \"22348 Regnart RD\",\n  \"zipCode\": \"25401\",\n  \"county\": \"<string>\",\n  \"propertyType\": \"Single Family Home\",\n  \"bedrooms\": 3,\n  \"bathrooms\": 2,\n  \"squareFeet\": 100,\n  \"lotSize\": 26.33,\n  \"parkingSpace\": 1,\n  \"floors\": 1,\n  \"mailAddress\": true,\n  \"id\": 123,\n  \"leadUserId\": 123,\n  \"listingId\": \"<string>\",\n  \"autoListingId\": 123,\n  \"label\": \"<string>\",\n  \"note\": \"<string>\",\n  \"listingStatus\": \"<string>\",\n  \"labelList\": \"<string>\",\n  \"pictureUrl\": \"<string>\",\n  \"siteListingUrl\": \"<string>\",\n  \"labelType\": \"<string>\",\n  \"priceMax\": 10000000,\n  \"priceMin\": 100000\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.lofty.com/v1.0/leads/{leadId}/property")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request.body = "{\n  \"price\": 100000,\n  \"state\": \"California\",\n  \"city\": \"New York\",\n  \"streetAddress\": \"22348 Regnart RD\",\n  \"zipCode\": \"25401\",\n  \"county\": \"<string>\",\n  \"propertyType\": \"Single Family Home\",\n  \"bedrooms\": 3,\n  \"bathrooms\": 2,\n  \"squareFeet\": 100,\n  \"lotSize\": 26.33,\n  \"parkingSpace\": 1,\n  \"floors\": 1,\n  \"mailAddress\": true,\n  \"id\": 123,\n  \"leadUserId\": 123,\n  \"listingId\": \"<string>\",\n  \"autoListingId\": 123,\n  \"label\": \"<string>\",\n  \"note\": \"<string>\",\n  \"listingStatus\": \"<string>\",\n  \"labelList\": \"<string>\",\n  \"pictureUrl\": \"<string>\",\n  \"siteListingUrl\": \"<string>\",\n  \"labelType\": \"<string>\",\n  \"priceMax\": 10000000,\n  \"priceMin\": 100000\n}"

response = http.request(request)
puts response.read_body

{
  "leadId": 651095960136641
}

"<string>"

"<string>"

"<string>"

"<string>"

Headers

Authorization

string

required

Bearer [access_token]

Content-Type

string

required

application/json

Path Parameters

leadId

integer<int64>

required

Body

application/json

Lead property or mailing address details

price

integer<int64>

The price Applies to lead routing only if the leadType field is Seller(1)

Example:

100000

state

string

The state Applies to lead routing only if the leadType field is Seller(1)

Example:

"California"

city

string

The city Applies to lead routing only if the leadType field is Seller(1)

Example:

"New York"

streetAddress

string

The street address Applies to lead routing only if the leadType field is Seller(1)

Example:

"22348 Regnart RD"

zipCode

string

The zip code Applies to lead routing only if the leadType field is Seller(1)

Example:

"25401"

county

string

The county Applies to lead routing only if the leadType field is Seller(1)

propertyType

string

Property type: Single Family Home, Multi-Family, Condo, Townhouse, Mobile Home, Manufactured Home, Vacant Land, Commercial.

Example:

"Single Family Home"

bedrooms

integer<int32>

The bed rooms.

Example:

3

bathrooms

number<double>

The bath rooms.

Example:

2

squareFeet

integer<int64>

The square feet.

Example:

100

lotSize

number<double>

The lot size (acreage).

Example:

26.33

parkingSpace

integer<int64>

The parking space.

Example:

1

floors

integer<int32>

The floors.

Example:

1

mailAddress

boolean

If set to true, the address is a mailing address; otherwise, it is a property address.

integer<int64>

The property ID. Required when updating an existing mailing address or property address. If not provided, a new address will be created.

leadUserId

integer<int64>

listingId

string

autoListingId

integer<int64>

label

string

note

string

listingStatus

string

labelList

string

pictureUrl

string

siteListingUrl

string

labelType

string

priceMax

integer<int64>

write-only

The max price Applies to lead routing only if the leadType field is Seller(1)

Example:

10000000

priceMin

integer<int64>

write-only

The min price Applies to lead routing only if the leadType field is Seller(1)

Example:

100000

Response

Property created or updated.

Response containing the lead ID.

leadId

integer<int64>

ID of the lead.

Example:

651095960136641

Preview Routing

Add Inquiry

Update Property Info

curl --request POST \
  --url https://api.lofty.com/v1.0/leads/{leadId}/property \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "price": 100000,
  "state": "California",
  "city": "New York",
  "streetAddress": "22348 Regnart RD",
  "zipCode": "25401",
  "county": "<string>",
  "propertyType": "Single Family Home",
  "bedrooms": 3,
  "bathrooms": 2,
  "squareFeet": 100,
  "lotSize": 26.33,
  "parkingSpace": 1,
  "floors": 1,
  "mailAddress": true,
  "id": 123,
  "leadUserId": 123,
  "listingId": "<string>",
  "autoListingId": 123,
  "label": "<string>",
  "note": "<string>",
  "listingStatus": "<string>",
  "labelList": "<string>",
  "pictureUrl": "<string>",
  "siteListingUrl": "<string>",
  "labelType": "<string>",
  "priceMax": 10000000,
  "priceMin": 100000
}
'

import requests

url = "https://api.lofty.com/v1.0/leads/{leadId}/property"

payload = {
    "price": 100000,
    "state": "California",
    "city": "New York",
    "streetAddress": "22348 Regnart RD",
    "zipCode": "25401",
    "county": "<string>",
    "propertyType": "Single Family Home",
    "bedrooms": 3,
    "bathrooms": 2,
    "squareFeet": 100,
    "lotSize": 26.33,
    "parkingSpace": 1,
    "floors": 1,
    "mailAddress": True,
    "id": 123,
    "leadUserId": 123,
    "listingId": "<string>",
    "autoListingId": 123,
    "label": "<string>",
    "note": "<string>",
    "listingStatus": "<string>",
    "labelList": "<string>",
    "pictureUrl": "<string>",
    "siteListingUrl": "<string>",
    "labelType": "<string>",
    "priceMax": 10000000,
    "priceMin": 100000
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({
    price: 100000,
    state: 'California',
    city: 'New York',
    streetAddress: '22348 Regnart RD',
    zipCode: '25401',
    county: '<string>',
    propertyType: 'Single Family Home',
    bedrooms: 3,
    bathrooms: 2,
    squareFeet: 100,
    lotSize: 26.33,
    parkingSpace: 1,
    floors: 1,
    mailAddress: true,
    id: 123,
    leadUserId: 123,
    listingId: '<string>',
    autoListingId: 123,
    label: '<string>',
    note: '<string>',
    listingStatus: '<string>',
    labelList: '<string>',
    pictureUrl: '<string>',
    siteListingUrl: '<string>',
    labelType: '<string>',
    priceMax: 10000000,
    priceMin: 100000
  })
};

fetch('https://api.lofty.com/v1.0/leads/{leadId}/property', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lofty.com/v1.0/leads/{leadId}/property",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'price' => 100000,
    'state' => 'California',
    'city' => 'New York',
    'streetAddress' => '22348 Regnart RD',
    'zipCode' => '25401',
    'county' => '<string>',
    'propertyType' => 'Single Family Home',
    'bedrooms' => 3,
    'bathrooms' => 2,
    'squareFeet' => 100,
    'lotSize' => 26.33,
    'parkingSpace' => 1,
    'floors' => 1,
    'mailAddress' => true,
    'id' => 123,
    'leadUserId' => 123,
    'listingId' => '<string>',
    'autoListingId' => 123,
    'label' => '<string>',
    'note' => '<string>',
    'listingStatus' => '<string>',
    'labelList' => '<string>',
    'pictureUrl' => '<string>',
    'siteListingUrl' => '<string>',
    'labelType' => '<string>',
    'priceMax' => 10000000,
    'priceMin' => 100000
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: <content-type>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lofty.com/v1.0/leads/{leadId}/property"

	payload := strings.NewReader("{\n  \"price\": 100000,\n  \"state\": \"California\",\n  \"city\": \"New York\",\n  \"streetAddress\": \"22348 Regnart RD\",\n  \"zipCode\": \"25401\",\n  \"county\": \"<string>\",\n  \"propertyType\": \"Single Family Home\",\n  \"bedrooms\": 3,\n  \"bathrooms\": 2,\n  \"squareFeet\": 100,\n  \"lotSize\": 26.33,\n  \"parkingSpace\": 1,\n  \"floors\": 1,\n  \"mailAddress\": true,\n  \"id\": 123,\n  \"leadUserId\": 123,\n  \"listingId\": \"<string>\",\n  \"autoListingId\": 123,\n  \"label\": \"<string>\",\n  \"note\": \"<string>\",\n  \"listingStatus\": \"<string>\",\n  \"labelList\": \"<string>\",\n  \"pictureUrl\": \"<string>\",\n  \"siteListingUrl\": \"<string>\",\n  \"labelType\": \"<string>\",\n  \"priceMax\": 10000000,\n  \"priceMin\": 100000\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.lofty.com/v1.0/leads/{leadId}/property")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "<content-type>")
  .body("{\n  \"price\": 100000,\n  \"state\": \"California\",\n  \"city\": \"New York\",\n  \"streetAddress\": \"22348 Regnart RD\",\n  \"zipCode\": \"25401\",\n  \"county\": \"<string>\",\n  \"propertyType\": \"Single Family Home\",\n  \"bedrooms\": 3,\n  \"bathrooms\": 2,\n  \"squareFeet\": 100,\n  \"lotSize\": 26.33,\n  \"parkingSpace\": 1,\n  \"floors\": 1,\n  \"mailAddress\": true,\n  \"id\": 123,\n  \"leadUserId\": 123,\n  \"listingId\": \"<string>\",\n  \"autoListingId\": 123,\n  \"label\": \"<string>\",\n  \"note\": \"<string>\",\n  \"listingStatus\": \"<string>\",\n  \"labelList\": \"<string>\",\n  \"pictureUrl\": \"<string>\",\n  \"siteListingUrl\": \"<string>\",\n  \"labelType\": \"<string>\",\n  \"priceMax\": 10000000,\n  \"priceMin\": 100000\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.lofty.com/v1.0/leads/{leadId}/property")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request.body = "{\n  \"price\": 100000,\n  \"state\": \"California\",\n  \"city\": \"New York\",\n  \"streetAddress\": \"22348 Regnart RD\",\n  \"zipCode\": \"25401\",\n  \"county\": \"<string>\",\n  \"propertyType\": \"Single Family Home\",\n  \"bedrooms\": 3,\n  \"bathrooms\": 2,\n  \"squareFeet\": 100,\n  \"lotSize\": 26.33,\n  \"parkingSpace\": 1,\n  \"floors\": 1,\n  \"mailAddress\": true,\n  \"id\": 123,\n  \"leadUserId\": 123,\n  \"listingId\": \"<string>\",\n  \"autoListingId\": 123,\n  \"label\": \"<string>\",\n  \"note\": \"<string>\",\n  \"listingStatus\": \"<string>\",\n  \"labelList\": \"<string>\",\n  \"pictureUrl\": \"<string>\",\n  \"siteListingUrl\": \"<string>\",\n  \"labelType\": \"<string>\",\n  \"priceMax\": 10000000,\n  \"priceMin\": 100000\n}"

response = http.request(request)
puts response.read_body

{
  "leadId": 651095960136641
}

"<string>"

"<string>"

"<string>"

"<string>"

Leads

Task & Calendar

Transactions

Listings

Communication

Team

AI Copilot

Webhooks

Integrations

Update Property Info

Headers

Path Parameters

Body

Response