Skip to main content
POST
Update the interest status of a lead

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:

"01a082d0-8428-75ac-b7c3-deff0e47a4fc"

ai_interest_value
number

The AI interest value to set for the lead.

Example:

1

disable_auto_interest
boolean

Suppresses AI-authored interest handling when ai_interest_value is supplied. Without an AI value, an explicit interest_value update retains normal effects: campaign leads may be completed, opportunities updated or created, and matching automations and CRM-status subsequences triggered.

Example:

true

list_id
string

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

Example:

"01a082d0-8428-75ac-b7c3-df009b7fa3b8"

Response

Default Response

message
string
Example:

"Lead interest status update background job submitted"