Skip to main content
POST
/
api
/
v2
/
leads
/
update-interest-status
Update the interest status of a lead
curl --request POST \
  --url https://api.instantly.ai/api/v2/leads/update-interest-status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "lead_email": "test@test.com",
  "interest_value": 1
}
'
{
  "message": "Lead interest status update background job submitted"
}

Documentation Index

Fetch the complete documentation index at: https://developer.instantly.ai/llms.txt

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

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
lead_email
string
required

The email of the lead to update the interest status of.

Example:

"test@test.com"

​
interest_value
number | null
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.

Example:

1

​
campaign_id
string

The ID of the campaign to update the interest status of.

Example:

"019e3bd1-b5db-7f43-b4ce-66723266c2b2"

​
ai_interest_value
number

The AI interest value to set for the lead.

Example:

1

​
disable_auto_interest
boolean

Whether to disable the auto interest.

Example:

true

​
list_id
string

The ID of the list to update the interest status of.

Example:

"019e3bd1-b5db-7f43-b4ce-6673d5582880"

Response

Default Response

​
message
string
Example:

"Lead interest status update background job submitted"