Skip to main content
POST
/
v1.0
/
leads
/
{leadId}
/
activity
Add activity
curl --request POST \
  --url https://api.lofty.com/v1.0/leads/{leadId}/activity \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "type": "Search",
  "text": "Search",
  "link": "https://lofty.com",
  "picture": "https://lofty.com/default.jpg",
  "created": 1747272300000,
  "listing": {
    "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
  },
  "scheduledDate": "<string>",
  "pageName": "Blog Registration"
}
'
{
  "leadId": 651095960136641
}

Documentation Index

Fetch the complete documentation index at: https://developer.lofty.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
Authorization
string
required

Bearer [access_token]

​
Content-Type
string
required

application/json

Path Parameters

​
leadId
integer<int64>
required

Body

application/json
​
type
string
required

Specifies the type of activity being logged for the lead.

Accepted Values:

  • Search: When the lead performs a search operation (e.g., filtering by property type like Single Family Home)
  • Browse: When the lead views a property detail page
  • Favorite: When the lead saves a property to favorites
  • Request: When the lead submits a showing request for a property
  • Submission: When the lead submits a form on website
Example:

"Search"

​
text
string
required

Search Text

Example:

"Search"

​
link
string
required

Url for web page

Example:

"https://lofty.com"

​
picture
string
required

Preview picture url

Example:

"https://lofty.com/default.jpg"

​
created
integer<int64>
required

created time in milliseconds

Example:

1747272300000

​
listing
object

Lead property or mailing address details

​
scheduledDate
string

Scheduled date about this showing request

​
pageName
string

The page name of the lead's submission(re-inquiry) page

Example:

"Blog Registration"

Response

200 - application/json

Successful operation.

Response containing the lead ID.

​
leadId
integer<int64>

ID of the lead.

Example:

651095960136641