curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/webhook/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "url": "https://example.com/lead-webhook" }'
{ "id": 7, "url": "https://example.com/lead-webhook", "created": "2026-09-08T10:00:00+05:30", "modified": "2026-09-08T10:00:00+05:30" }
Lead Webhooks
Create a lead list webhook
POST /lead//webhook/
POST
/
lead
/
{lead_id}
/
webhook
/
curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/webhook/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "url": "https://example.com/lead-webhook" }'
{ "id": 7, "url": "https://example.com/lead-webhook", "created": "2026-09-08T10:00:00+05:30", "modified": "2026-09-08T10:00:00+05:30" }
Adds a webhook to a lead list, called with the entry payload on every new form submission.
Requires a Management API key with
MANAGEMENT_API (or MANAGEMENT_API_SANDBOX) quota, and the LEAD_GENERATION_WEBHOOK_CAN_ADD permission, sent as the raw Authorization header value — see the Management API overview.string
required
The lead list’s
lead_id.string
required
The webhook’s target URL, up to 500 characters.
curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/webhook/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "url": "https://example.com/lead-webhook" }'
{ "id": 7, "url": "https://example.com/lead-webhook", "created": "2026-09-08T10:00:00+05:30", "modified": "2026-09-08T10:00:00+05:30" }
403 if the account’s plan has exhausted its webhook-per-lead-list quota:
403
{ "detail": "You have exhausted your limit of 5 webhooks.", "limit": 5 }
404 if lead_id isn’t owned by this account.
Related
- List lead list webhooks — see what’s already configured.
- Update a lead list webhook — change a webhook’s URL.
- Management API overview — the auth scheme and quota architecture this endpoint is part of.
Authorizations
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Response
201
Webhook created.
Was this page helpful?