Core
Update Lead
Updates an existing lead. Caller must have manage permission on the lead.
Property block
If the request body carries a property block, it is persisted alongside the lead update with the same semantics as POST /v1.0/leads/{leadId}/property:
property.idomitted or<= 0— merge with an existing property by address; if no match, create a new property record. (Prior versions of this endpoint rejected this case withUPDATE_LEAD_PROPERTY_FAILED; that restriction has been lifted.)property.id > 0— update the named property in place. The property must belong to this lead (itsleadUserIdmust match); otherwise the request is rejected with 200108 LEAD_PROPERTY_NOT_EXIST.
Validation:
- When a
propertyblock is supplied, at least one ofcity,state,zipCode,streetAddressmust be non-blank; otherwise 200057 PROPERTY_ADDRESS_EMPTY is returned (the lead update is also aborted).
PUT
/
v1.0
/
leads
/
{leadId}
Update Lead
curl --request PUT \
--url https://api.lofty.com/v1.0/leads/{leadId} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>' \
--data '
{
"cannotText": true,
"cannotCall": true,
"cannotEmail": true,
"firstName": "Bob",
"lastName": "Li",
"emails": [
"jane.doe@example.com",
"jdoe-work@company.com"
],
"phones": [
"+14155551234",
"+12125559876"
],
"leadTypes": [
2,
5
],
"assignedUserId": 10000000514,
"streetAddress": "The White House,1600 Pennsylvania Avenue NW",
"city": "Washington DC",
"state": "Washington DC",
"zipCode": "20500",
"referredBy": "Jeremy Kelly",
"isHidden": false,
"stage": "Pending",
"groups": [
"VIP Clients",
"Open House Feb"
],
"segments": [
"First-Time Buyers",
"Downtown Area"
],
"tags": [
"Hot Lead",
"Zillow"
],
"tagsAdd": [
"Referral",
"Pre-Approved"
],
"source": "Open House",
"inquiry": {
"priceMin": 1,
"priceMax": 10000000,
"propertyType": [
"Single Family Home",
"Condo"
],
"bedroomsMin": 1,
"bathroomsMin": "1",
"locations": [
{
"city": "Austin",
"stateCode": "TX"
}
],
"id": 123,
"leadUserId": 123,
"bedroomsMax": 123,
"bathroomsMax": "<string>",
"modifyByAgent": true,
"createTime": "2023-11-07T05:31:56Z",
"updateTime": "2023-11-07T05:31:56Z",
"defaultValue": true
},
"property": {
"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
},
"customAttributeList": [
{
"attributeName": "<string>",
"attributeType": "number, text, date, anniversary_date, single_select, multi_select, percentage, currency",
"value": "<string>",
"params": "<string>"
}
],
"birthday": "Jun 5, 2001",
"buyingTimeFrame": "6-12",
"preQual": "Yes",
"houseToSell": "Yes",
"fthb": "Yes",
"withBuyerAgent": "Yes",
"sellingTimeFrame": "1-3",
"mortgage": "Yes",
"buyHouse": "Yes",
"withListingAgent": "Yes",
"leadFamilyMemberList": [
{
"firstName": "<string>",
"relationship": "<string>",
"lastName": "<string>",
"phones": [
"+14155551234"
],
"emails": [
"spouse@example.com"
],
"birthday": "<string>"
}
],
"language": "en",
"ownershipId": 123,
"ownershipScope": "TEAM",
"unsubscription": true,
"tagsRemove": [
"Hot Lead"
],
"clearAllTags": false
}
'import requests
url = "https://api.lofty.com/v1.0/leads/{leadId}"
payload = {
"cannotText": True,
"cannotCall": True,
"cannotEmail": True,
"firstName": "Bob",
"lastName": "Li",
"emails": ["jane.doe@example.com", "jdoe-work@company.com"],
"phones": ["+14155551234", "+12125559876"],
"leadTypes": [2, 5],
"assignedUserId": 10000000514,
"streetAddress": "The White House,1600 Pennsylvania Avenue NW",
"city": "Washington DC",
"state": "Washington DC",
"zipCode": "20500",
"referredBy": "Jeremy Kelly",
"isHidden": False,
"stage": "Pending",
"groups": ["VIP Clients", "Open House Feb"],
"segments": ["First-Time Buyers", "Downtown Area"],
"tags": ["Hot Lead", "Zillow"],
"tagsAdd": ["Referral", "Pre-Approved"],
"source": "Open House",
"inquiry": {
"priceMin": 1,
"priceMax": 10000000,
"propertyType": ["Single Family Home", "Condo"],
"bedroomsMin": 1,
"bathroomsMin": "1",
"locations": [
{
"city": "Austin",
"stateCode": "TX"
}
],
"id": 123,
"leadUserId": 123,
"bedroomsMax": 123,
"bathroomsMax": "<string>",
"modifyByAgent": True,
"createTime": "2023-11-07T05:31:56Z",
"updateTime": "2023-11-07T05:31:56Z",
"defaultValue": True
},
"property": {
"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
},
"customAttributeList": [
{
"attributeName": "<string>",
"attributeType": "number, text, date, anniversary_date, single_select, multi_select, percentage, currency",
"value": "<string>",
"params": "<string>"
}
],
"birthday": "Jun 5, 2001",
"buyingTimeFrame": "6-12",
"preQual": "Yes",
"houseToSell": "Yes",
"fthb": "Yes",
"withBuyerAgent": "Yes",
"sellingTimeFrame": "1-3",
"mortgage": "Yes",
"buyHouse": "Yes",
"withListingAgent": "Yes",
"leadFamilyMemberList": [
{
"firstName": "<string>",
"relationship": "<string>",
"lastName": "<string>",
"phones": ["+14155551234"],
"emails": ["spouse@example.com"],
"birthday": "<string>"
}
],
"language": "en",
"ownershipId": 123,
"ownershipScope": "TEAM",
"unsubscription": True,
"tagsRemove": ["Hot Lead"],
"clearAllTags": False
}
headers = {
"Authorization": "<authorization>",
"Content-Type": "<content-type>"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'},
body: JSON.stringify({
cannotText: true,
cannotCall: true,
cannotEmail: true,
firstName: 'Bob',
lastName: 'Li',
emails: ['jane.doe@example.com', 'jdoe-work@company.com'],
phones: ['+14155551234', '+12125559876'],
leadTypes: [2, 5],
assignedUserId: 10000000514,
streetAddress: 'The White House,1600 Pennsylvania Avenue NW',
city: 'Washington DC',
state: 'Washington DC',
zipCode: '20500',
referredBy: 'Jeremy Kelly',
isHidden: false,
stage: 'Pending',
groups: ['VIP Clients', 'Open House Feb'],
segments: ['First-Time Buyers', 'Downtown Area'],
tags: ['Hot Lead', 'Zillow'],
tagsAdd: ['Referral', 'Pre-Approved'],
source: 'Open House',
inquiry: {
priceMin: 1,
priceMax: 10000000,
propertyType: ['Single Family Home', 'Condo'],
bedroomsMin: 1,
bathroomsMin: '1',
locations: [{city: 'Austin', stateCode: 'TX'}],
id: 123,
leadUserId: 123,
bedroomsMax: 123,
bathroomsMax: '<string>',
modifyByAgent: true,
createTime: '2023-11-07T05:31:56Z',
updateTime: '2023-11-07T05:31:56Z',
defaultValue: true
},
property: {
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
},
customAttributeList: [
{
attributeName: '<string>',
attributeType: 'number, text, date, anniversary_date, single_select, multi_select, percentage, currency',
value: '<string>',
params: '<string>'
}
],
birthday: 'Jun 5, 2001',
buyingTimeFrame: '6-12',
preQual: 'Yes',
houseToSell: 'Yes',
fthb: 'Yes',
withBuyerAgent: 'Yes',
sellingTimeFrame: '1-3',
mortgage: 'Yes',
buyHouse: 'Yes',
withListingAgent: 'Yes',
leadFamilyMemberList: [
{
firstName: '<string>',
relationship: '<string>',
lastName: '<string>',
phones: ['+14155551234'],
emails: ['spouse@example.com'],
birthday: '<string>'
}
],
language: 'en',
ownershipId: 123,
ownershipScope: 'TEAM',
unsubscription: true,
tagsRemove: ['Hot Lead'],
clearAllTags: false
})
};
fetch('https://api.lofty.com/v1.0/leads/{leadId}', 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}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'cannotText' => true,
'cannotCall' => true,
'cannotEmail' => true,
'firstName' => 'Bob',
'lastName' => 'Li',
'emails' => [
'jane.doe@example.com',
'jdoe-work@company.com'
],
'phones' => [
'+14155551234',
'+12125559876'
],
'leadTypes' => [
2,
5
],
'assignedUserId' => 10000000514,
'streetAddress' => 'The White House,1600 Pennsylvania Avenue NW',
'city' => 'Washington DC',
'state' => 'Washington DC',
'zipCode' => '20500',
'referredBy' => 'Jeremy Kelly',
'isHidden' => false,
'stage' => 'Pending',
'groups' => [
'VIP Clients',
'Open House Feb'
],
'segments' => [
'First-Time Buyers',
'Downtown Area'
],
'tags' => [
'Hot Lead',
'Zillow'
],
'tagsAdd' => [
'Referral',
'Pre-Approved'
],
'source' => 'Open House',
'inquiry' => [
'priceMin' => 1,
'priceMax' => 10000000,
'propertyType' => [
'Single Family Home',
'Condo'
],
'bedroomsMin' => 1,
'bathroomsMin' => '1',
'locations' => [
[
'city' => 'Austin',
'stateCode' => 'TX'
]
],
'id' => 123,
'leadUserId' => 123,
'bedroomsMax' => 123,
'bathroomsMax' => '<string>',
'modifyByAgent' => true,
'createTime' => '2023-11-07T05:31:56Z',
'updateTime' => '2023-11-07T05:31:56Z',
'defaultValue' => true
],
'property' => [
'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
],
'customAttributeList' => [
[
'attributeName' => '<string>',
'attributeType' => 'number, text, date, anniversary_date, single_select, multi_select, percentage, currency',
'value' => '<string>',
'params' => '<string>'
]
],
'birthday' => 'Jun 5, 2001',
'buyingTimeFrame' => '6-12',
'preQual' => 'Yes',
'houseToSell' => 'Yes',
'fthb' => 'Yes',
'withBuyerAgent' => 'Yes',
'sellingTimeFrame' => '1-3',
'mortgage' => 'Yes',
'buyHouse' => 'Yes',
'withListingAgent' => 'Yes',
'leadFamilyMemberList' => [
[
'firstName' => '<string>',
'relationship' => '<string>',
'lastName' => '<string>',
'phones' => [
'+14155551234'
],
'emails' => [
'spouse@example.com'
],
'birthday' => '<string>'
]
],
'language' => 'en',
'ownershipId' => 123,
'ownershipScope' => 'TEAM',
'unsubscription' => true,
'tagsRemove' => [
'Hot Lead'
],
'clearAllTags' => false
]),
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}"
payload := strings.NewReader("{\n \"cannotText\": true,\n \"cannotCall\": true,\n \"cannotEmail\": true,\n \"firstName\": \"Bob\",\n \"lastName\": \"Li\",\n \"emails\": [\n \"jane.doe@example.com\",\n \"jdoe-work@company.com\"\n ],\n \"phones\": [\n \"+14155551234\",\n \"+12125559876\"\n ],\n \"leadTypes\": [\n 2,\n 5\n ],\n \"assignedUserId\": 10000000514,\n \"streetAddress\": \"The White House,1600 Pennsylvania Avenue NW\",\n \"city\": \"Washington DC\",\n \"state\": \"Washington DC\",\n \"zipCode\": \"20500\",\n \"referredBy\": \"Jeremy Kelly\",\n \"isHidden\": false,\n \"stage\": \"Pending\",\n \"groups\": [\n \"VIP Clients\",\n \"Open House Feb\"\n ],\n \"segments\": [\n \"First-Time Buyers\",\n \"Downtown Area\"\n ],\n \"tags\": [\n \"Hot Lead\",\n \"Zillow\"\n ],\n \"tagsAdd\": [\n \"Referral\",\n \"Pre-Approved\"\n ],\n \"source\": \"Open House\",\n \"inquiry\": {\n \"priceMin\": 1,\n \"priceMax\": 10000000,\n \"propertyType\": [\n \"Single Family Home\",\n \"Condo\"\n ],\n \"bedroomsMin\": 1,\n \"bathroomsMin\": \"1\",\n \"locations\": [\n {\n \"city\": \"Austin\",\n \"stateCode\": \"TX\"\n }\n ],\n \"id\": 123,\n \"leadUserId\": 123,\n \"bedroomsMax\": 123,\n \"bathroomsMax\": \"<string>\",\n \"modifyByAgent\": true,\n \"createTime\": \"2023-11-07T05:31:56Z\",\n \"updateTime\": \"2023-11-07T05:31:56Z\",\n \"defaultValue\": true\n },\n \"property\": {\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 },\n \"customAttributeList\": [\n {\n \"attributeName\": \"<string>\",\n \"attributeType\": \"number, text, date, anniversary_date, single_select, multi_select, percentage, currency\",\n \"value\": \"<string>\",\n \"params\": \"<string>\"\n }\n ],\n \"birthday\": \"Jun 5, 2001\",\n \"buyingTimeFrame\": \"6-12\",\n \"preQual\": \"Yes\",\n \"houseToSell\": \"Yes\",\n \"fthb\": \"Yes\",\n \"withBuyerAgent\": \"Yes\",\n \"sellingTimeFrame\": \"1-3\",\n \"mortgage\": \"Yes\",\n \"buyHouse\": \"Yes\",\n \"withListingAgent\": \"Yes\",\n \"leadFamilyMemberList\": [\n {\n \"firstName\": \"<string>\",\n \"relationship\": \"<string>\",\n \"lastName\": \"<string>\",\n \"phones\": [\n \"+14155551234\"\n ],\n \"emails\": [\n \"spouse@example.com\"\n ],\n \"birthday\": \"<string>\"\n }\n ],\n \"language\": \"en\",\n \"ownershipId\": 123,\n \"ownershipScope\": \"TEAM\",\n \"unsubscription\": true,\n \"tagsRemove\": [\n \"Hot Lead\"\n ],\n \"clearAllTags\": false\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.lofty.com/v1.0/leads/{leadId}")
.header("Authorization", "<authorization>")
.header("Content-Type", "<content-type>")
.body("{\n \"cannotText\": true,\n \"cannotCall\": true,\n \"cannotEmail\": true,\n \"firstName\": \"Bob\",\n \"lastName\": \"Li\",\n \"emails\": [\n \"jane.doe@example.com\",\n \"jdoe-work@company.com\"\n ],\n \"phones\": [\n \"+14155551234\",\n \"+12125559876\"\n ],\n \"leadTypes\": [\n 2,\n 5\n ],\n \"assignedUserId\": 10000000514,\n \"streetAddress\": \"The White House,1600 Pennsylvania Avenue NW\",\n \"city\": \"Washington DC\",\n \"state\": \"Washington DC\",\n \"zipCode\": \"20500\",\n \"referredBy\": \"Jeremy Kelly\",\n \"isHidden\": false,\n \"stage\": \"Pending\",\n \"groups\": [\n \"VIP Clients\",\n \"Open House Feb\"\n ],\n \"segments\": [\n \"First-Time Buyers\",\n \"Downtown Area\"\n ],\n \"tags\": [\n \"Hot Lead\",\n \"Zillow\"\n ],\n \"tagsAdd\": [\n \"Referral\",\n \"Pre-Approved\"\n ],\n \"source\": \"Open House\",\n \"inquiry\": {\n \"priceMin\": 1,\n \"priceMax\": 10000000,\n \"propertyType\": [\n \"Single Family Home\",\n \"Condo\"\n ],\n \"bedroomsMin\": 1,\n \"bathroomsMin\": \"1\",\n \"locations\": [\n {\n \"city\": \"Austin\",\n \"stateCode\": \"TX\"\n }\n ],\n \"id\": 123,\n \"leadUserId\": 123,\n \"bedroomsMax\": 123,\n \"bathroomsMax\": \"<string>\",\n \"modifyByAgent\": true,\n \"createTime\": \"2023-11-07T05:31:56Z\",\n \"updateTime\": \"2023-11-07T05:31:56Z\",\n \"defaultValue\": true\n },\n \"property\": {\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 },\n \"customAttributeList\": [\n {\n \"attributeName\": \"<string>\",\n \"attributeType\": \"number, text, date, anniversary_date, single_select, multi_select, percentage, currency\",\n \"value\": \"<string>\",\n \"params\": \"<string>\"\n }\n ],\n \"birthday\": \"Jun 5, 2001\",\n \"buyingTimeFrame\": \"6-12\",\n \"preQual\": \"Yes\",\n \"houseToSell\": \"Yes\",\n \"fthb\": \"Yes\",\n \"withBuyerAgent\": \"Yes\",\n \"sellingTimeFrame\": \"1-3\",\n \"mortgage\": \"Yes\",\n \"buyHouse\": \"Yes\",\n \"withListingAgent\": \"Yes\",\n \"leadFamilyMemberList\": [\n {\n \"firstName\": \"<string>\",\n \"relationship\": \"<string>\",\n \"lastName\": \"<string>\",\n \"phones\": [\n \"+14155551234\"\n ],\n \"emails\": [\n \"spouse@example.com\"\n ],\n \"birthday\": \"<string>\"\n }\n ],\n \"language\": \"en\",\n \"ownershipId\": 123,\n \"ownershipScope\": \"TEAM\",\n \"unsubscription\": true,\n \"tagsRemove\": [\n \"Hot Lead\"\n ],\n \"clearAllTags\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lofty.com/v1.0/leads/{leadId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request.body = "{\n \"cannotText\": true,\n \"cannotCall\": true,\n \"cannotEmail\": true,\n \"firstName\": \"Bob\",\n \"lastName\": \"Li\",\n \"emails\": [\n \"jane.doe@example.com\",\n \"jdoe-work@company.com\"\n ],\n \"phones\": [\n \"+14155551234\",\n \"+12125559876\"\n ],\n \"leadTypes\": [\n 2,\n 5\n ],\n \"assignedUserId\": 10000000514,\n \"streetAddress\": \"The White House,1600 Pennsylvania Avenue NW\",\n \"city\": \"Washington DC\",\n \"state\": \"Washington DC\",\n \"zipCode\": \"20500\",\n \"referredBy\": \"Jeremy Kelly\",\n \"isHidden\": false,\n \"stage\": \"Pending\",\n \"groups\": [\n \"VIP Clients\",\n \"Open House Feb\"\n ],\n \"segments\": [\n \"First-Time Buyers\",\n \"Downtown Area\"\n ],\n \"tags\": [\n \"Hot Lead\",\n \"Zillow\"\n ],\n \"tagsAdd\": [\n \"Referral\",\n \"Pre-Approved\"\n ],\n \"source\": \"Open House\",\n \"inquiry\": {\n \"priceMin\": 1,\n \"priceMax\": 10000000,\n \"propertyType\": [\n \"Single Family Home\",\n \"Condo\"\n ],\n \"bedroomsMin\": 1,\n \"bathroomsMin\": \"1\",\n \"locations\": [\n {\n \"city\": \"Austin\",\n \"stateCode\": \"TX\"\n }\n ],\n \"id\": 123,\n \"leadUserId\": 123,\n \"bedroomsMax\": 123,\n \"bathroomsMax\": \"<string>\",\n \"modifyByAgent\": true,\n \"createTime\": \"2023-11-07T05:31:56Z\",\n \"updateTime\": \"2023-11-07T05:31:56Z\",\n \"defaultValue\": true\n },\n \"property\": {\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 },\n \"customAttributeList\": [\n {\n \"attributeName\": \"<string>\",\n \"attributeType\": \"number, text, date, anniversary_date, single_select, multi_select, percentage, currency\",\n \"value\": \"<string>\",\n \"params\": \"<string>\"\n }\n ],\n \"birthday\": \"Jun 5, 2001\",\n \"buyingTimeFrame\": \"6-12\",\n \"preQual\": \"Yes\",\n \"houseToSell\": \"Yes\",\n \"fthb\": \"Yes\",\n \"withBuyerAgent\": \"Yes\",\n \"sellingTimeFrame\": \"1-3\",\n \"mortgage\": \"Yes\",\n \"buyHouse\": \"Yes\",\n \"withListingAgent\": \"Yes\",\n \"leadFamilyMemberList\": [\n {\n \"firstName\": \"<string>\",\n \"relationship\": \"<string>\",\n \"lastName\": \"<string>\",\n \"phones\": [\n \"+14155551234\"\n ],\n \"emails\": [\n \"spouse@example.com\"\n ],\n \"birthday\": \"<string>\"\n }\n ],\n \"language\": \"en\",\n \"ownershipId\": 123,\n \"ownershipScope\": \"TEAM\",\n \"unsubscription\": true,\n \"tagsRemove\": [\n \"Hot Lead\"\n ],\n \"clearAllTags\": false\n}"
response = http.request(request)
puts response.read_body{
"leadId": 651095960136641
}"<string>""<string>""<string>""<string>"Silent truncation —
firstName, lastName, groups, segments are truncated to 30 characters; tags / tagsAdd to 64 characters. The API returns success with no error. Validate input length before sending.Path Parameters
ID of the lead to update.
Required range:
x >= 1Query Parameters
Defaults to false: the lead is updated in place. Pass true to also deduplicate: if another lead in the same team shares this lead's email after the update, this lead is merged into that lead (and this lead is deleted).
Body
application/json
Lead update payload.
false: can send message to the lead
false: can call to the lead
false: can email to the lead
The first/given name of the lead Caution: Max limit 30 characters. If you exceed the limit, the import will succuss, but only import 30 characters in front.
Example:
"Bob"
The last/family name of the lead Caution: Max limit 30 characters. If you exceed the limit, the import will succuss, but only import 30 characters in front.
Example:
"Li"
A list of email addresses associated with the lead
Example:
[
"jane.doe@example.com",
"jdoe-work@company.com"
]
A list of phone numbers associated with the lead. (No more than 20 characters per phone)
Example:
["+14155551234", "+12125559876"]
Types of lead, expressed by ID. Type ID : Other (-1), Seller (1), Buyer (2), Renter (5), Investor (6), Agent (7),Homeowner (8), Landlord (9)
Example:
[2, 5]
Id of the agent assigned to this contact
Example:
10000000514
The streetAddress associated with the lead. Deprecated: please use the streetAddress field in property instead.
Example:
"The White House,1600 Pennsylvania Avenue NW"
The city associated with the lead. Deprecated: please use the city field in property instead.
Example:
"Washington DC"
The state associated with the lead. Deprecated: please use the state field in property instead.
Example:
"Washington DC"
ZipCode. Deprecated: please use the zipCode field in property instead.
Example:
"20500"
The referee of the lead
Example:
"Jeremy Kelly"
The lead is hidden or not
Example:
false
The stage the lead is in, less than 20 characters
Example:
"Pending"
The groups the lead is in Caution: Max limit 30 characters.If you exceed the limit,the import will success , but only import 30 characters in front. deprecated, use segments instead.
Example:
["VIP Clients", "Open House Feb"]
The segments the lead is in Caution: Max limit 30 characters.If you exceed the limit,the import will success , but only import 30 characters in front.
Example:
["First-Time Buyers", "Downtown Area"]
The tags associated with the lead. All existing tags will be updated based on this call Caution: Max limit 64 characters.If you exceed the limit,the import will success , but only import 64 characters in front.
Example:
["Hot Lead", "Zillow"]
The tags associated with the lead. All existing tags will be retained, only add new tags base on this call Caution: Max limit 64 characters. If you exceed the limit, the import will success, but only import 64 characters in front.
Example:
["Referral", "Pre-Approved"]
The source of the lead
Example:
"Open House"
LeadInquirys
Show child attributes
Show child attributes
Lead property or mailing address details
Show child attributes
Show child attributes
User customized field
Show child attributes
Show child attributes
The birthday of the lead(pattern:MMM d, yyyy)
Example:
"Jun 5, 2001"
buying time frame, 1-3, 3-6, 6-12, 12+, Just Looking, Refinancing.
Example:
"6-12"
Pre-qual, Yes or No.
Example:
"Yes"
House to Sell, Yes or No.
Example:
"Yes"
first time home buyer, Yes or No.
Example:
"Yes"
With buyer Agent, Yes or No.
Example:
"Yes"
selling time frame, 1-3, 3-6, 6-12, 12+, Just Looking, Refinancing.
Example:
"1-3"
Mortgage, Yes or No.
Example:
"Yes"
Buy a house, Yes or No.
Example:
"Yes"
With listing agent, Yes or No.
Example:
"Yes"
A list of family members associated with the lead. You can add up to 4 family members.
Show child attributes
Show child attributes
The lead's abbreviated language, en, fr, de, es, zh-CN, zh-TW, ja
Example:
"en"
The entity ID for the ownership scope. Required when ownershipScope is OFFICE (pass the office ID) or PERSONAL (pass the agent's user ID). Ignored when ownershipScope is TEAM.
Controls the visibility scope of the lead. TEAM — Account-wide: visible to all users in this Lofty client account. OFFICE — visible only within the specified office (requires ownershipId). PERSONAL — visible only to the specified agent (requires ownershipId). Note: TEAM refers to the entire client account (the organization), not the Lofty "Team add-on" product.
Example:
"TEAM"
Unsubscription the email
Show child attributes
Show child attributes
Tags to remove from the lead, by literal name. Only tags that are already on the lead are affected — a name not currently on the lead is ignored (so a brand-new tag introduced by tags/tagsAdd in the same request is not affected). Names are matched literally, so a tag named "*" is removed like any other. To remove ALL tags use the clearAllTags flag instead. Applied after tags/tagsAdd; it does not change their behavior. Omit it to leave tags unchanged.
Example:
["Hot Lead"]
Set to true to remove ALL tags from the lead. Takes precedence over tags / tagsAdd / tagsRemove. Defaults to false (no change).
Example:
false
Response
Lead updated.
Response containing the lead ID.
ID of the lead.
Example:
651095960136641
⌘I
Update Lead
curl --request PUT \
--url https://api.lofty.com/v1.0/leads/{leadId} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>' \
--data '
{
"cannotText": true,
"cannotCall": true,
"cannotEmail": true,
"firstName": "Bob",
"lastName": "Li",
"emails": [
"jane.doe@example.com",
"jdoe-work@company.com"
],
"phones": [
"+14155551234",
"+12125559876"
],
"leadTypes": [
2,
5
],
"assignedUserId": 10000000514,
"streetAddress": "The White House,1600 Pennsylvania Avenue NW",
"city": "Washington DC",
"state": "Washington DC",
"zipCode": "20500",
"referredBy": "Jeremy Kelly",
"isHidden": false,
"stage": "Pending",
"groups": [
"VIP Clients",
"Open House Feb"
],
"segments": [
"First-Time Buyers",
"Downtown Area"
],
"tags": [
"Hot Lead",
"Zillow"
],
"tagsAdd": [
"Referral",
"Pre-Approved"
],
"source": "Open House",
"inquiry": {
"priceMin": 1,
"priceMax": 10000000,
"propertyType": [
"Single Family Home",
"Condo"
],
"bedroomsMin": 1,
"bathroomsMin": "1",
"locations": [
{
"city": "Austin",
"stateCode": "TX"
}
],
"id": 123,
"leadUserId": 123,
"bedroomsMax": 123,
"bathroomsMax": "<string>",
"modifyByAgent": true,
"createTime": "2023-11-07T05:31:56Z",
"updateTime": "2023-11-07T05:31:56Z",
"defaultValue": true
},
"property": {
"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
},
"customAttributeList": [
{
"attributeName": "<string>",
"attributeType": "number, text, date, anniversary_date, single_select, multi_select, percentage, currency",
"value": "<string>",
"params": "<string>"
}
],
"birthday": "Jun 5, 2001",
"buyingTimeFrame": "6-12",
"preQual": "Yes",
"houseToSell": "Yes",
"fthb": "Yes",
"withBuyerAgent": "Yes",
"sellingTimeFrame": "1-3",
"mortgage": "Yes",
"buyHouse": "Yes",
"withListingAgent": "Yes",
"leadFamilyMemberList": [
{
"firstName": "<string>",
"relationship": "<string>",
"lastName": "<string>",
"phones": [
"+14155551234"
],
"emails": [
"spouse@example.com"
],
"birthday": "<string>"
}
],
"language": "en",
"ownershipId": 123,
"ownershipScope": "TEAM",
"unsubscription": true,
"tagsRemove": [
"Hot Lead"
],
"clearAllTags": false
}
'import requests
url = "https://api.lofty.com/v1.0/leads/{leadId}"
payload = {
"cannotText": True,
"cannotCall": True,
"cannotEmail": True,
"firstName": "Bob",
"lastName": "Li",
"emails": ["jane.doe@example.com", "jdoe-work@company.com"],
"phones": ["+14155551234", "+12125559876"],
"leadTypes": [2, 5],
"assignedUserId": 10000000514,
"streetAddress": "The White House,1600 Pennsylvania Avenue NW",
"city": "Washington DC",
"state": "Washington DC",
"zipCode": "20500",
"referredBy": "Jeremy Kelly",
"isHidden": False,
"stage": "Pending",
"groups": ["VIP Clients", "Open House Feb"],
"segments": ["First-Time Buyers", "Downtown Area"],
"tags": ["Hot Lead", "Zillow"],
"tagsAdd": ["Referral", "Pre-Approved"],
"source": "Open House",
"inquiry": {
"priceMin": 1,
"priceMax": 10000000,
"propertyType": ["Single Family Home", "Condo"],
"bedroomsMin": 1,
"bathroomsMin": "1",
"locations": [
{
"city": "Austin",
"stateCode": "TX"
}
],
"id": 123,
"leadUserId": 123,
"bedroomsMax": 123,
"bathroomsMax": "<string>",
"modifyByAgent": True,
"createTime": "2023-11-07T05:31:56Z",
"updateTime": "2023-11-07T05:31:56Z",
"defaultValue": True
},
"property": {
"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
},
"customAttributeList": [
{
"attributeName": "<string>",
"attributeType": "number, text, date, anniversary_date, single_select, multi_select, percentage, currency",
"value": "<string>",
"params": "<string>"
}
],
"birthday": "Jun 5, 2001",
"buyingTimeFrame": "6-12",
"preQual": "Yes",
"houseToSell": "Yes",
"fthb": "Yes",
"withBuyerAgent": "Yes",
"sellingTimeFrame": "1-3",
"mortgage": "Yes",
"buyHouse": "Yes",
"withListingAgent": "Yes",
"leadFamilyMemberList": [
{
"firstName": "<string>",
"relationship": "<string>",
"lastName": "<string>",
"phones": ["+14155551234"],
"emails": ["spouse@example.com"],
"birthday": "<string>"
}
],
"language": "en",
"ownershipId": 123,
"ownershipScope": "TEAM",
"unsubscription": True,
"tagsRemove": ["Hot Lead"],
"clearAllTags": False
}
headers = {
"Authorization": "<authorization>",
"Content-Type": "<content-type>"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'},
body: JSON.stringify({
cannotText: true,
cannotCall: true,
cannotEmail: true,
firstName: 'Bob',
lastName: 'Li',
emails: ['jane.doe@example.com', 'jdoe-work@company.com'],
phones: ['+14155551234', '+12125559876'],
leadTypes: [2, 5],
assignedUserId: 10000000514,
streetAddress: 'The White House,1600 Pennsylvania Avenue NW',
city: 'Washington DC',
state: 'Washington DC',
zipCode: '20500',
referredBy: 'Jeremy Kelly',
isHidden: false,
stage: 'Pending',
groups: ['VIP Clients', 'Open House Feb'],
segments: ['First-Time Buyers', 'Downtown Area'],
tags: ['Hot Lead', 'Zillow'],
tagsAdd: ['Referral', 'Pre-Approved'],
source: 'Open House',
inquiry: {
priceMin: 1,
priceMax: 10000000,
propertyType: ['Single Family Home', 'Condo'],
bedroomsMin: 1,
bathroomsMin: '1',
locations: [{city: 'Austin', stateCode: 'TX'}],
id: 123,
leadUserId: 123,
bedroomsMax: 123,
bathroomsMax: '<string>',
modifyByAgent: true,
createTime: '2023-11-07T05:31:56Z',
updateTime: '2023-11-07T05:31:56Z',
defaultValue: true
},
property: {
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
},
customAttributeList: [
{
attributeName: '<string>',
attributeType: 'number, text, date, anniversary_date, single_select, multi_select, percentage, currency',
value: '<string>',
params: '<string>'
}
],
birthday: 'Jun 5, 2001',
buyingTimeFrame: '6-12',
preQual: 'Yes',
houseToSell: 'Yes',
fthb: 'Yes',
withBuyerAgent: 'Yes',
sellingTimeFrame: '1-3',
mortgage: 'Yes',
buyHouse: 'Yes',
withListingAgent: 'Yes',
leadFamilyMemberList: [
{
firstName: '<string>',
relationship: '<string>',
lastName: '<string>',
phones: ['+14155551234'],
emails: ['spouse@example.com'],
birthday: '<string>'
}
],
language: 'en',
ownershipId: 123,
ownershipScope: 'TEAM',
unsubscription: true,
tagsRemove: ['Hot Lead'],
clearAllTags: false
})
};
fetch('https://api.lofty.com/v1.0/leads/{leadId}', 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}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'cannotText' => true,
'cannotCall' => true,
'cannotEmail' => true,
'firstName' => 'Bob',
'lastName' => 'Li',
'emails' => [
'jane.doe@example.com',
'jdoe-work@company.com'
],
'phones' => [
'+14155551234',
'+12125559876'
],
'leadTypes' => [
2,
5
],
'assignedUserId' => 10000000514,
'streetAddress' => 'The White House,1600 Pennsylvania Avenue NW',
'city' => 'Washington DC',
'state' => 'Washington DC',
'zipCode' => '20500',
'referredBy' => 'Jeremy Kelly',
'isHidden' => false,
'stage' => 'Pending',
'groups' => [
'VIP Clients',
'Open House Feb'
],
'segments' => [
'First-Time Buyers',
'Downtown Area'
],
'tags' => [
'Hot Lead',
'Zillow'
],
'tagsAdd' => [
'Referral',
'Pre-Approved'
],
'source' => 'Open House',
'inquiry' => [
'priceMin' => 1,
'priceMax' => 10000000,
'propertyType' => [
'Single Family Home',
'Condo'
],
'bedroomsMin' => 1,
'bathroomsMin' => '1',
'locations' => [
[
'city' => 'Austin',
'stateCode' => 'TX'
]
],
'id' => 123,
'leadUserId' => 123,
'bedroomsMax' => 123,
'bathroomsMax' => '<string>',
'modifyByAgent' => true,
'createTime' => '2023-11-07T05:31:56Z',
'updateTime' => '2023-11-07T05:31:56Z',
'defaultValue' => true
],
'property' => [
'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
],
'customAttributeList' => [
[
'attributeName' => '<string>',
'attributeType' => 'number, text, date, anniversary_date, single_select, multi_select, percentage, currency',
'value' => '<string>',
'params' => '<string>'
]
],
'birthday' => 'Jun 5, 2001',
'buyingTimeFrame' => '6-12',
'preQual' => 'Yes',
'houseToSell' => 'Yes',
'fthb' => 'Yes',
'withBuyerAgent' => 'Yes',
'sellingTimeFrame' => '1-3',
'mortgage' => 'Yes',
'buyHouse' => 'Yes',
'withListingAgent' => 'Yes',
'leadFamilyMemberList' => [
[
'firstName' => '<string>',
'relationship' => '<string>',
'lastName' => '<string>',
'phones' => [
'+14155551234'
],
'emails' => [
'spouse@example.com'
],
'birthday' => '<string>'
]
],
'language' => 'en',
'ownershipId' => 123,
'ownershipScope' => 'TEAM',
'unsubscription' => true,
'tagsRemove' => [
'Hot Lead'
],
'clearAllTags' => false
]),
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}"
payload := strings.NewReader("{\n \"cannotText\": true,\n \"cannotCall\": true,\n \"cannotEmail\": true,\n \"firstName\": \"Bob\",\n \"lastName\": \"Li\",\n \"emails\": [\n \"jane.doe@example.com\",\n \"jdoe-work@company.com\"\n ],\n \"phones\": [\n \"+14155551234\",\n \"+12125559876\"\n ],\n \"leadTypes\": [\n 2,\n 5\n ],\n \"assignedUserId\": 10000000514,\n \"streetAddress\": \"The White House,1600 Pennsylvania Avenue NW\",\n \"city\": \"Washington DC\",\n \"state\": \"Washington DC\",\n \"zipCode\": \"20500\",\n \"referredBy\": \"Jeremy Kelly\",\n \"isHidden\": false,\n \"stage\": \"Pending\",\n \"groups\": [\n \"VIP Clients\",\n \"Open House Feb\"\n ],\n \"segments\": [\n \"First-Time Buyers\",\n \"Downtown Area\"\n ],\n \"tags\": [\n \"Hot Lead\",\n \"Zillow\"\n ],\n \"tagsAdd\": [\n \"Referral\",\n \"Pre-Approved\"\n ],\n \"source\": \"Open House\",\n \"inquiry\": {\n \"priceMin\": 1,\n \"priceMax\": 10000000,\n \"propertyType\": [\n \"Single Family Home\",\n \"Condo\"\n ],\n \"bedroomsMin\": 1,\n \"bathroomsMin\": \"1\",\n \"locations\": [\n {\n \"city\": \"Austin\",\n \"stateCode\": \"TX\"\n }\n ],\n \"id\": 123,\n \"leadUserId\": 123,\n \"bedroomsMax\": 123,\n \"bathroomsMax\": \"<string>\",\n \"modifyByAgent\": true,\n \"createTime\": \"2023-11-07T05:31:56Z\",\n \"updateTime\": \"2023-11-07T05:31:56Z\",\n \"defaultValue\": true\n },\n \"property\": {\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 },\n \"customAttributeList\": [\n {\n \"attributeName\": \"<string>\",\n \"attributeType\": \"number, text, date, anniversary_date, single_select, multi_select, percentage, currency\",\n \"value\": \"<string>\",\n \"params\": \"<string>\"\n }\n ],\n \"birthday\": \"Jun 5, 2001\",\n \"buyingTimeFrame\": \"6-12\",\n \"preQual\": \"Yes\",\n \"houseToSell\": \"Yes\",\n \"fthb\": \"Yes\",\n \"withBuyerAgent\": \"Yes\",\n \"sellingTimeFrame\": \"1-3\",\n \"mortgage\": \"Yes\",\n \"buyHouse\": \"Yes\",\n \"withListingAgent\": \"Yes\",\n \"leadFamilyMemberList\": [\n {\n \"firstName\": \"<string>\",\n \"relationship\": \"<string>\",\n \"lastName\": \"<string>\",\n \"phones\": [\n \"+14155551234\"\n ],\n \"emails\": [\n \"spouse@example.com\"\n ],\n \"birthday\": \"<string>\"\n }\n ],\n \"language\": \"en\",\n \"ownershipId\": 123,\n \"ownershipScope\": \"TEAM\",\n \"unsubscription\": true,\n \"tagsRemove\": [\n \"Hot Lead\"\n ],\n \"clearAllTags\": false\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.lofty.com/v1.0/leads/{leadId}")
.header("Authorization", "<authorization>")
.header("Content-Type", "<content-type>")
.body("{\n \"cannotText\": true,\n \"cannotCall\": true,\n \"cannotEmail\": true,\n \"firstName\": \"Bob\",\n \"lastName\": \"Li\",\n \"emails\": [\n \"jane.doe@example.com\",\n \"jdoe-work@company.com\"\n ],\n \"phones\": [\n \"+14155551234\",\n \"+12125559876\"\n ],\n \"leadTypes\": [\n 2,\n 5\n ],\n \"assignedUserId\": 10000000514,\n \"streetAddress\": \"The White House,1600 Pennsylvania Avenue NW\",\n \"city\": \"Washington DC\",\n \"state\": \"Washington DC\",\n \"zipCode\": \"20500\",\n \"referredBy\": \"Jeremy Kelly\",\n \"isHidden\": false,\n \"stage\": \"Pending\",\n \"groups\": [\n \"VIP Clients\",\n \"Open House Feb\"\n ],\n \"segments\": [\n \"First-Time Buyers\",\n \"Downtown Area\"\n ],\n \"tags\": [\n \"Hot Lead\",\n \"Zillow\"\n ],\n \"tagsAdd\": [\n \"Referral\",\n \"Pre-Approved\"\n ],\n \"source\": \"Open House\",\n \"inquiry\": {\n \"priceMin\": 1,\n \"priceMax\": 10000000,\n \"propertyType\": [\n \"Single Family Home\",\n \"Condo\"\n ],\n \"bedroomsMin\": 1,\n \"bathroomsMin\": \"1\",\n \"locations\": [\n {\n \"city\": \"Austin\",\n \"stateCode\": \"TX\"\n }\n ],\n \"id\": 123,\n \"leadUserId\": 123,\n \"bedroomsMax\": 123,\n \"bathroomsMax\": \"<string>\",\n \"modifyByAgent\": true,\n \"createTime\": \"2023-11-07T05:31:56Z\",\n \"updateTime\": \"2023-11-07T05:31:56Z\",\n \"defaultValue\": true\n },\n \"property\": {\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 },\n \"customAttributeList\": [\n {\n \"attributeName\": \"<string>\",\n \"attributeType\": \"number, text, date, anniversary_date, single_select, multi_select, percentage, currency\",\n \"value\": \"<string>\",\n \"params\": \"<string>\"\n }\n ],\n \"birthday\": \"Jun 5, 2001\",\n \"buyingTimeFrame\": \"6-12\",\n \"preQual\": \"Yes\",\n \"houseToSell\": \"Yes\",\n \"fthb\": \"Yes\",\n \"withBuyerAgent\": \"Yes\",\n \"sellingTimeFrame\": \"1-3\",\n \"mortgage\": \"Yes\",\n \"buyHouse\": \"Yes\",\n \"withListingAgent\": \"Yes\",\n \"leadFamilyMemberList\": [\n {\n \"firstName\": \"<string>\",\n \"relationship\": \"<string>\",\n \"lastName\": \"<string>\",\n \"phones\": [\n \"+14155551234\"\n ],\n \"emails\": [\n \"spouse@example.com\"\n ],\n \"birthday\": \"<string>\"\n }\n ],\n \"language\": \"en\",\n \"ownershipId\": 123,\n \"ownershipScope\": \"TEAM\",\n \"unsubscription\": true,\n \"tagsRemove\": [\n \"Hot Lead\"\n ],\n \"clearAllTags\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lofty.com/v1.0/leads/{leadId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request.body = "{\n \"cannotText\": true,\n \"cannotCall\": true,\n \"cannotEmail\": true,\n \"firstName\": \"Bob\",\n \"lastName\": \"Li\",\n \"emails\": [\n \"jane.doe@example.com\",\n \"jdoe-work@company.com\"\n ],\n \"phones\": [\n \"+14155551234\",\n \"+12125559876\"\n ],\n \"leadTypes\": [\n 2,\n 5\n ],\n \"assignedUserId\": 10000000514,\n \"streetAddress\": \"The White House,1600 Pennsylvania Avenue NW\",\n \"city\": \"Washington DC\",\n \"state\": \"Washington DC\",\n \"zipCode\": \"20500\",\n \"referredBy\": \"Jeremy Kelly\",\n \"isHidden\": false,\n \"stage\": \"Pending\",\n \"groups\": [\n \"VIP Clients\",\n \"Open House Feb\"\n ],\n \"segments\": [\n \"First-Time Buyers\",\n \"Downtown Area\"\n ],\n \"tags\": [\n \"Hot Lead\",\n \"Zillow\"\n ],\n \"tagsAdd\": [\n \"Referral\",\n \"Pre-Approved\"\n ],\n \"source\": \"Open House\",\n \"inquiry\": {\n \"priceMin\": 1,\n \"priceMax\": 10000000,\n \"propertyType\": [\n \"Single Family Home\",\n \"Condo\"\n ],\n \"bedroomsMin\": 1,\n \"bathroomsMin\": \"1\",\n \"locations\": [\n {\n \"city\": \"Austin\",\n \"stateCode\": \"TX\"\n }\n ],\n \"id\": 123,\n \"leadUserId\": 123,\n \"bedroomsMax\": 123,\n \"bathroomsMax\": \"<string>\",\n \"modifyByAgent\": true,\n \"createTime\": \"2023-11-07T05:31:56Z\",\n \"updateTime\": \"2023-11-07T05:31:56Z\",\n \"defaultValue\": true\n },\n \"property\": {\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 },\n \"customAttributeList\": [\n {\n \"attributeName\": \"<string>\",\n \"attributeType\": \"number, text, date, anniversary_date, single_select, multi_select, percentage, currency\",\n \"value\": \"<string>\",\n \"params\": \"<string>\"\n }\n ],\n \"birthday\": \"Jun 5, 2001\",\n \"buyingTimeFrame\": \"6-12\",\n \"preQual\": \"Yes\",\n \"houseToSell\": \"Yes\",\n \"fthb\": \"Yes\",\n \"withBuyerAgent\": \"Yes\",\n \"sellingTimeFrame\": \"1-3\",\n \"mortgage\": \"Yes\",\n \"buyHouse\": \"Yes\",\n \"withListingAgent\": \"Yes\",\n \"leadFamilyMemberList\": [\n {\n \"firstName\": \"<string>\",\n \"relationship\": \"<string>\",\n \"lastName\": \"<string>\",\n \"phones\": [\n \"+14155551234\"\n ],\n \"emails\": [\n \"spouse@example.com\"\n ],\n \"birthday\": \"<string>\"\n }\n ],\n \"language\": \"en\",\n \"ownershipId\": 123,\n \"ownershipScope\": \"TEAM\",\n \"unsubscription\": true,\n \"tagsRemove\": [\n \"Hot Lead\"\n ],\n \"clearAllTags\": false\n}"
response = http.request(request)
puts response.read_body{
"leadId": 651095960136641
}"<string>""<string>""<string>""<string>"