---
title: "Update the interest status of a lead"
method: POST
path: "/api/v2/leads/update-interest-status"
tags: ["Lead"]
---

# Update the interest status of a lead

`POST /api/v2/leads/update-interest-status`

Update the interest status of a lead

## Request body

- object
  - `lead_email` string, required — The email of the lead to update the interest status of.
  - `interest_value` number, nullable, required — Set this field to "null" to reset the lead value to "Lead". This is the same as moving the lead to the "Lead" status in the web app. Please check the `lt_interest_status` field for the list of possible values.
  - `campaign_id` string — The ID of the campaign to update the interest status of.
  - `ai_interest_value` number — The AI interest value to set for the lead.
  - `disable_auto_interest` boolean — Whether to disable the auto interest.
  - `list_id` string — The ID of the list to update the interest status of.

## Response `202`

Default Response

- object
  - `message` string

## Other responses

- `400` — Default Response
- `401` — This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402` — This request cannot be fulfilled because the workspace does not have an active paid plan
- `404` — The requested resource was not found
- `429` — You have exceeded the rate limit. Please check the rate limit docs for more information.

---

[API](https://skmtc.net/instantly/apis/api-explorer.md) · [All operations](https://skmtc.net/instantly/apis/api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instantly/api-explorer/versions/378d1e253fe7/schema)