PlatformDocs
MCP server

recalculate_lead_scores

Re-run lead scoring for specific leads against the website's current scoring models, and answer any AI qualification questions those leads do not have an answer for yet.

View as Markdown

Re-score leads · Changes data

Re-run lead scoring for specific leads against the website's current scoring models, and answer any AI qualification questions those leads do not have an answer for yet. Use it after changing a model with update_lead_scoring_model when you want selected leads updated now. AI questions count against the plan's monthly AI qualification allowance; leads that already have every answer are re-scored without any AI use (counted in aiSkipped). websiteId from list_websites, leadIds from get_leads; leadIds must contain at least one id (an empty list is refused). Leads are processed one by one, so keep batches small. Returns processed, failed, total, aiSkipped and updatedLeads[] (_id, scores, aiQualification).

ConnectionAccount URL, team member URL or OAuth

Parameters

ParameterTypeRequiredAcceptsDescription
websiteIdstringYesanyWebsite id (24 hex characters) from list_websites.
leadIdsstring[]YesanyArray of lead ids from get_leads to re-score. At least one id.

Tool definition

What your assistant receives from tools/list:

{
  "name": "recalculate_lead_scores",
  "title": "Re-score leads",
  "annotations": {
    "title": "Re-score leads",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "websiteId": {
        "type": "string",
        "description": "Website id (24 hex characters) from list_websites."
      },
      "leadIds": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Array of lead ids from get_leads to re-score. At least one id."
      }
    },
    "required": [
      "websiteId",
      "leadIds"
    ]
  }
}

On this page