---
title: "Add activity"
method: POST
path: "/v1.0/leads/{leadId}/activity"
tags: ["Leads"]
---

# Add activity

`POST /v1.0/leads/{leadId}/activity`

Add activity to a lead.

## Path parameters

- `leadId` integer, required

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- LeadActivity
  - `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
  - `text` string, required — Search Text
  - `link` string, required — Url for web page
  - `picture` string, required — Preview picture url
  - `listing` LeadProperty — Lead property or mailing address details
    - `price` integer — The price Applies to lead routing only if the leadType field is Seller(1)
    - `state` string — The state Applies to lead routing only if the leadType field is Seller(1)
    - `city` string — The city Applies to lead routing only if the leadType field is Seller(1)
    - `streetAddress` string — The street address Applies to lead routing only if the leadType field is Seller(1)
    - `zipCode` string — The zip code Applies to lead routing only if the leadType field is Seller(1)
    - `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`.
    - `bedrooms` integer — The bed rooms.
    - `bathrooms` number, double — The bath rooms.
    - `squareFeet` integer — The square feet.
    - `lotSize` number, double — The lot size (acreage).
    - `parkingSpace` integer — The parking space.
    - `floors` integer — The floors.
    - `mailAddress` boolean — If set to true, the address is a mailing address; otherwise, it is a property address.
    - `id` integer — The property ID. Required when updating an existing mailing address or property address. If not provided, a new address will be created.
    - `leadUserId` integer
    - `listingId` string
    - `autoListingId` integer
    - `label` string
    - `note` string
    - `listingStatus` string
    - `labelList` string
    - `pictureUrl` string
    - `siteListingUrl` string
    - `labelType` string
    - `priceMax` integer — The max price Applies to lead routing only if the leadType field is Seller(1)
    - `priceMin` integer — The min price Applies to lead routing only if the leadType field is Seller(1)
  - `created` integer, required — created time in milliseconds
  - `scheduledDate` string — Scheduled date about this showing request
  - `pageName` string — The page name of the lead's submission(re-inquiry) page

## Response `200`

Successful operation.

- LeadIdResponse — Response containing the lead ID.
  - `leadId` integer — ID of the lead.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/revisions/23e640467118/schema)