API Reference

Integrate with Leadyen programmatically to fetch leads, manage configurations, and verify webhooks.

Authentication

Use API keys from your dashboard. Include the key as a Bearer token.

Authorization: Bearer YOUR_API_KEY

Fetch recent leads delivered to your account. Filter by status, category, or created date.

GET /api/leads?limit=50&status=new

Response includes id, contact details, metadata, and delivery status.

Verify the `x-webhook-token` or signed headers depending on integration when receiving webhooks. See the Webhooks page for examples.

Standard JSON errors with `error` and `message` fields. Rate limits may apply; retry with backoff.