Lead Scans

Scan a URL and email a whitelabeled partial report to a recipient

Studio plan only. Scans an arbitrary URL (no Site record is created) and emails a whitelabeled "top 5 issues" partial report to recipient_email once the scan completes. Built for a lead-capture form on the account's own site. Any form tool that can send an authenticated POST request can call it. See docs/superpowers/specs/2026-09-29-lead-capture-scan-api-design.md. A duplicate (url, recipient_email) submission within 10 minutes returns the existing LeadScan instead of scanning again. If a scan cannot be completed the visitor is not emailed; the account's users get an email listing the visitor's address instead.

post/lead_scans

Request

  • Base URL: https://sitecurl.com/api/v1
  • URL: https://sitecurl.com/api/v1/lead_scans
  • Auth: HTTP bearer

Request body

urlstring uri required
recipient_emailstring email required
recipient_namestring

Response

Scan queued (or an existing duplicate LeadScan within the dedupe window)

Changes

No recorded changes to this operation across all 1 revision of this API.