Skip to content
Klozeo Docs

Your first request

  1. Create a free account at klozeo.com and generate an API key.

  2. 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": "contact@acme.com",
        "city": "San Francisco"
      }'

    Response (201 Created):

    {
      "id": "cl_01234567-89ab-cdef-0123-456789abcdef",
      "name": "Acme Corporation",
      "source": "website",
      "email": "contact@acme.com",
      "city": "San Francisco",
      "score": 0,
      "created_at": 1703520000,
      "updated_at": 1703520000,
      "last_interaction_at": 1703520000
    }

    A few things to note in this response:

    • score: 0 is expected — scores are calculated once you configure scoring rules.
    • Timestamps (created_at, updated_at, last_interaction_at) are Unix seconds (not milliseconds). For JavaScript: new Date(1703520000 * 1000) → December 25, 2023.

  3. List your leads:

    Terminal window
    curl https://api.klozeo.com/api/v1/leads \
      -H "X-API-Key: sk_live_your_key"

  4. 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/v1

Next steps

Section titled “Next steps”