INinstantly
Lead

Update the interest status of a lead

Update the interest status of a lead

post/api/v2/leads/update-interest-status

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/leads/update-interest-status
  • Auth
    HTTP bearer

Request body

lead_emailstring required

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

interest_valuenumber 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_idstring

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

ai_interest_valuenumber

The AI interest value to set for the lead.

disable_auto_interestboolean

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.

list_idstring

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

Example request

{
  "lead_email": "test@test.com",
  "interest_value": 1,
  "campaign_id": "01a19e6f-8db3-7b5c-93bd-70e6b44932b7",
  "ai_interest_value": 1,
  "disable_auto_interest": true,
  "list_id": "01a19e6f-8db3-7b5c-93bd-70e7633ba359"
}

Response

Default Response

messagestring

Example response

{
  "message": "Lead interest status update background job submitted"
}

Changes

No recorded changes to this operation across all 6 revisions of this API.