Aller au contenu
Klozeo Docs

Votre première requête

  1. Créez un compte gratuit sur klozeo.com et générez une clé API.

  2. Créez votre premier lead :

    Fenêtre de terminal
    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"
      }'

    Réponse (201 Created) :

    {
      "id": "cl_01234567-89ab-cdef-0123-456789abcdef",
      "message": "Lead created successfully",
      "created_at": 1703520000
    }

    Quelques points à noter dans cette réponse :

    • La réponse confirme l’écriture et vous donne l’id du lead. Récupérez le lead complet avec GET /leads/{id}.
    • created_at est en secondes Unix (pas en millisecondes). En JavaScript : new Date(1703520000 * 1000), soit le 25 décembre 2023.
    • Si un lead avec le même email existe déjà, Klozeo fusionne la requête dans ce lead à la place : le statut est 200 OK, l’id est celui du lead existant et le corps contient "duplicate": true.

  3. Listez vos leads :

    Fenêtre de terminal
    curl https://api.klozeo.com/api/v1/leads \
      -H "X-API-Key: sk_live_your_key"

  4. Filtrez par ville :

    Fenêtre de terminal
    curl "https://api.klozeo.com/api/v1/leads?filter=and.eq.city.San+Francisco" \
      -H "X-API-Key: sk_live_your_key"

URL de base

Section intitulée « URL de base »

Tous les endpoints de l’API sont préfixés par :

https://api.klozeo.com/api/v1

Étapes suivantes

Section intitulée « Étapes suivantes »