Log in Get an API key

API Reference › Webhooks

Lead List Completed

WEBHOOK Your webhook URL

When a Lead Builder list completes, Tracerfy POSTs the result to the webhook_url configured on your account, the same account-level URL used for skip trace and DNC webhooks. This eliminates the need to poll /status/, your server gets notified the moment the CSV is ready. How to use: set your webhook_url in your account settings. When a lead list completes successfully, Tracerfy sends a POST with the payload below. Your endpoint should return 2xx within 10 seconds. Webhooks fire for lists created through the API or the AI connector, and for every Monitor delivery. A non-null monitor_id tells you a Monitor produced the list. Retry: Tracerfy does not retry failed webhook deliveries. If your server is down when the webhook fires, use /status/ as a fallback to check completion. Tracerfy sends this JSON to your Account.webhook_url when a lead list completes.