HappierleadsDocs
MCP server

update_lead_quality

Changes the lead quality settings of a website.

Update the lead quality bar · Changes data

Changes the lead quality settings of a website. Leads scoring below the bar are not added (and use no credits). Only the fields you pass change; the highest bar is 80 (20 on lifetime-deal plans).

ConnectionAccount URL, team member URL or OAuth

Parameters

ParameterTypeRequiredDescription
websiteIdstringYesWebsite ID from list_websites.
minScorenumberNoMinimum ideal-customer score for every source (0-80).
bySourceobjectNoPer-source bars that override minScore.
bySource.visitorsnumberNoMinimum score for website visitor leads (0-80); null uses the general bar.
bySource.intentnumberNoMinimum score for 3rd-party intent leads (0-80); null uses the general bar.
bySource.scrapingnumberNoMinimum score for Web Scraping leads (0-80); null uses the general bar.
bySource.prospectornumberNoMinimum score for Prospector leads (0-80); null uses the general bar.
bySource.scoutnumberNoMinimum score for AI Scout leads (0-80); null uses the general bar.
contactsOnlybooleanNoOnly keep leads with a person to contact.
audienceFocus"B2B" | "B2C" | "BOTH"NoB2B, B2C or BOTH.

Tool definition

What your assistant receives from tools/list:

{
  "name": "update_lead_quality",
  "title": "Update the lead quality bar",
  "annotations": {
    "title": "Update the lead quality bar",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "websiteId": {
        "type": "string",
        "description": "Website ID from list_websites."
      },
      "minScore": {
        "type": "number",
        "minimum": 0,
        "maximum": 80,
        "description": "Minimum ideal-customer score for every source (0-80)."
      },
      "bySource": {
        "type": "object",
        "properties": {
          "visitors": {
            "type": "number",
            "minimum": 0,
            "maximum": 80,
            "description": "Minimum score for website visitor leads (0-80); null uses the general bar."
          },
          "intent": {
            "type": "number",
            "minimum": 0,
            "maximum": 80,
            "description": "Minimum score for 3rd-party intent leads (0-80); null uses the general bar."
          },
          "scraping": {
            "type": "number",
            "minimum": 0,
            "maximum": 80,
            "description": "Minimum score for Web Scraping leads (0-80); null uses the general bar."
          },
          "prospector": {
            "type": "number",
            "minimum": 0,
            "maximum": 80,
            "description": "Minimum score for Prospector leads (0-80); null uses the general bar."
          },
          "scout": {
            "type": "number",
            "minimum": 0,
            "maximum": 80,
            "description": "Minimum score for AI Scout leads (0-80); null uses the general bar."
          }
        },
        "description": "Per-source bars that override minScore."
      },
      "contactsOnly": {
        "type": "boolean",
        "description": "Only keep leads with a person to contact."
      },
      "audienceFocus": {
        "type": "string",
        "enum": [
          "B2B",
          "B2C",
          "BOTH"
        ],
        "description": "B2B, B2C or BOTH."
      }
    },
    "required": [
      "websiteId"
    ]
  }
}

On this page