Connecting Zapier to Lead Recorder

API reference for the Lead Recorder Zapier app: authentication, the New Lead trigger, and every endpoint it calls.

The Lead Recorder Zapier app lets you send new leads into any other tool — a CRM, Slack, a spreadsheet — the moment they're captured on your site. It authenticates with a personal API key and polls for new leads on a short interval; this page documents the underlying API for reviewers and for anyone building against it directly.

Authentication

Every request is authenticated with a personal API key, sent as a header:

X-Api-Key: lr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Generate a key from your Lead Recorder dashboard under Account → API access. Keys are account-scoped: a key grants access to whatever sites the generating user can already see (an admin sees every site on the account, a client only the sites they've been given access to). Regenerating a key immediately invalidates the previous one. A request with a missing or invalid key returns 401 Unauthorized.

GET /api/zapier/auth/test

Validates an API key. This is the endpoint Zapier calls when a user connects their account.

curl -H "X-Api-Key: lr_xxx" https://www.leadrecorder.com/api/zapier/auth/test

200 OK
{ "email": "you@example.com" }

GET /api/zapier/sites

Lists the sites the authenticated account can access. Powers the site dropdown on the New Lead trigger.

curl -H "X-Api-Key: lr_xxx" https://www.leadrecorder.com/api/zapier/sites

200 OK
[
  { "id": "abc123", "name": "My Website", "domain": "example.com" }
]

GET /api/zapier/leads

Returns leads for a given site, newest first — the data source behind the New Lead trigger. Requires a siteId query parameter, and 404s if the authenticated account can't access that site. History is capped by the site owner's plan, same as the leads list in the dashboard.

curl -H "X-Api-Key: lr_xxx" \
  "https://www.leadrecorder.com/api/zapier/leads?siteId=abc123"

200 OK
[
  {
    "id": "lead_abc123",
    "submittedAt": "2026-07-28T04:32:10.000Z",
    "status": "new",
    "type": "form",
    "formPage": "/contact",
    "nameField": "Jane Smith",
    "emailField": "jane@example.com",
    "phoneNumber": "+61 400 000 000",
    "utmSource": "google",
    "utmMedium": "cpc",
    "utmCampaign": "brand",
    "utmTerm": null,
    "referrer": "https://www.google.com/",
    "landingPage": "/",
    "device": "desktop",
    "city": "Sydney",
    "country": "AU",
    "region": "NSW"
  }
]

New Lead trigger

A polling trigger: once connected, pick a site from the dropdown and Zapier checks for new leads on that site automatically. No webhook setup or extra configuration is needed.