---
title: "Update Lead Status"
method: PUT
path: "/leads/{leadId}/status"
---

# Update Lead Status

`PUT /leads/{leadId}/status`

Updates the status and substatus of an existing lead. You can have status as OPEN (for new lead), WON (for a successful purchase lead), LOST (for unreverted lead), ON_HOLD, DELETED.

## Request body

- object
  - `status` 'OPEN' | 'WON' | 'LOST' | 'ON_HOLD' | 'DELETED', required — Status for which you want to add sub-status.
  - `subStatus` string — Name of the new sub-status that you want to create.
  - `reasonId` string, required — Reason id that you want to associate to the lead.
  - `createdBy` integer — Entity id of the staff who created the lead.
  - `createdOn` string, date — Date and time of lead creation in YYYY-MM-DDThh:mm:ssTZD format. Example: 2018-10-05T08:00:00+05:30

## Response `200`

200

- object
  - `id` integer
  - `userId` integer
  - `type` string
  - `leadFor` string
  - `status` string
  - `nextFollowUp` string
  - `createdOn` string
  - `createdBy` integer
  - `lastUpdatedOn` string
  - `lastUpdatedBy` integer
  - `followUpDetails` object[]
    - `id` integer
    - `userId` integer
    - `leadId` integer
    - `notes` string
    - `createdBy` integer
    - `createdOn` string
    - `followedUpBy` integer
    - `followedUpOn` string
    - `scheduledFollowUp` string
  - `statusLogDetails` object[]
    - `id` integer
    - `userId` integer
    - `leadId` integer
    - `status` string
    - `createdBy` integer
    - `createdOn` string
    - `reasonId` integer
    - `reason` string
  - `orgSourceId` integer
  - `extendedFields` object
    - `trial_status` string
  - `subStatus` string
  - `warnings` unknown[]
    - unknown

---

[API](https://skmtc.net/capillarytech/apis/sample-api.md) · [All operations](https://skmtc.net/capillarytech/apis/sample-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/capillarytech/sample-api/revisions/de241f2ed9b3/schema)