PlatformDocs

Re-qualify existing leads

Score the leads you already have again after changing a model.

Authenticated with ?privateKey=YOUR_KEY (see Authentication).

POST/v3/lead-scoring/recalculate
Try:
Request body
Website IdWebsite id (24 hex characters) from list_websites.
Lead IdsArray of lead ids from get_leads to re-score. At least one id.
6530c1d2e3f4a5b6c7d8e9f2
curl -X POST "https://rest-dash.revealid.xyz/v3/lead-scoring/recalculate?privateKey=YOUR_KEY" \  -H "Content-Type: application/json" \  -d '{  "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9",  "leadIds": [    "6530c1d2e3f4a5b6c7d8e9f2"  ]}'
Response
Press Send request to try it with sample data.

What each field accepts

FieldTypeLimits and formatAccepted values
websiteId*string—any
leadIds*string[]—any

Use case: Rescore after a CRM update

POST /v3/lead-scoring/recalculate with the leadIds whose data changed (at least one; an empty list is refused). Leads are processed one by one, so send small batches. The answer has processed, failed, aiSkipped (leads rescored without any AI use because every AI prompt was already answered) and updatedLeads[] with each lead's new scores.

On this page