Your first request
-
Create a free account at klozeo.com and generate an API key.
-
Create your first lead:
Terminal window curl -X POST https://api.klozeo.com/api/v1/leads \-H "X-API-Key: sk_live_your_key" \-H "Content-Type: application/json" \-d '{"name": "Acme Corporation","source": "website","email": "[email protected]","city": "San Francisco"}'Response (
201 Created):{"id": "cl_01234567-89ab-cdef-0123-456789abcdef","message": "Lead created successfully","created_at": 1703520000}A few things to note in this response:
- The response confirms the write and gives you the lead’s
id. Fetch the full lead withGET /leads/{id}. created_atis in Unix seconds (not milliseconds). For JavaScript:new Date(1703520000 * 1000)→ December 25, 2023.- If a lead with the same email already exists, Klozeo merges into it instead: the status is
200 OK,idis the existing lead’s, and the body includes"duplicate": true.
- The response confirms the write and gives you the lead’s
-
List your leads:
Terminal window curl https://api.klozeo.com/api/v1/leads \-H "X-API-Key: sk_live_your_key" -
Filter by city:
Terminal window curl "https://api.klozeo.com/api/v1/leads?filter=and.eq.city.San+Francisco" \-H "X-API-Key: sk_live_your_key"
Base URL
Section titled “Base URL”All API endpoints are prefixed with:
https://api.klozeo.com/api/v1Next steps
Section titled “Next steps”- Learn filtering: 20+ operators including
within_radiusfor geo search - Set up MCP: let Claude query your leads in natural language
- Configure scoring rules: automatically score leads 0–100