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

# Add activity

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

## Request

- Base URL: `https://api.lofty.com`
- URL: `https://api.lofty.com/v1.0/leads/{leadId}/activity`
- Auth: none required
- TypeScript: <https://skmtc.dev/lofty/apis/lofty-service-open-apis/docs/v1.0/leads/:leadId/activity/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/lofty/apis/lofty-service-open-apis.md) - [All operations](https://skmtc.dev/lofty/apis/lofty-service-open-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/lofty/apis/lofty-service-open-apis/revisions/23e640467118?raw)