Klantly Developers

Démarrage rapide

D'une nouvelle clé API à votre premier client via l'API, en cinq minutes.

1. Créez une clé API

Dans Klantly, allez dans Intégrations → API et choisissez Nouvelle clé. Donnez un nom à la clé, choisissez Accès complet et cliquez sur Créer la clé. Copiez la clé immédiatement : vous ne la reverrez plus jamais.

Attention

Ne placez jamais une clé dans le code d'un site web ou d'une application. Conservez-la sur votre serveur, par exemple dans une variable d'environnement.

Terminal
export KLANTLY_API_KEY="kly_..."

2. Testez votre connexion

cURL
curl "https://app.klantly.com/api/v1/me" \
  -H "Authorization: Bearer $KLANTLY_API_KEY"
PHP
$client = new \GuzzleHttp\Client([
    'base_uri' => 'https://app.klantly.com/api/v1/',
    'headers' => ['Authorization' => 'Bearer ' . getenv('KLANTLY_API_KEY')],
]);

$response = $client->request('GET', 'me');
$me = json_decode((string) $response->getBody(), true)['data'];

echo $me['company']['name'];
JavaScript
const response = await fetch('https://app.klantly.com/api/v1/me', {
  headers: { Authorization: `Bearer ${process.env.KLANTLY_API_KEY}` },
});
const { data } = await response.json();

console.log(data.company.name);
Python
import os

import requests

response = requests.get(
    "https://app.klantly.com/api/v1/me",
    headers={"Authorization": f"Bearer {os.environ['KLANTLY_API_KEY']}"},
)
print(response.json()["data"]["company"]["name"])

Si tout est correct, vous recevez votre clé, votre entreprise et vos limites. Vous obtenez une erreur ? Consultez les codes d'erreur.

3. Créez votre premier client

Envoyez un POST à /customers avec au moins une adresse e-mail :

Body
{
  "email": "jan@example.com",
  "name": "Jan de Vries",
  "type": "business",
  "company_name": "De Vries Bouw"
}
cURL
curl -X POST "https://app.klantly.com/api/v1/customers" \
  -H "Authorization: Bearer $KLANTLY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6f1c2d3e-4a5b-4c6d-8e7f-9a0b1c2d3e4f" \
  -d '{"email": "jan@example.com", "name": "Jan de Vries", "type": "business", "company_name": "De Vries Bouw"}'
PHP
$response = $client->request('POST', 'customers', [
    'headers' => ['Idempotency-Key' => '6f1c2d3e-4a5b-4c6d-8e7f-9a0b1c2d3e4f'],
    'json' => [
        'email' => 'jan@example.com',
        'name' => 'Jan de Vries',
        'type' => 'business',
        'company_name' => 'De Vries Bouw',
    ],
]);

$customer = json_decode((string) $response->getBody(), true)['data'];
JavaScript
const response = await fetch('https://app.klantly.com/api/v1/customers', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.KLANTLY_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': '6f1c2d3e-4a5b-4c6d-8e7f-9a0b1c2d3e4f',
  },
  body: JSON.stringify({
    email: 'jan@example.com',
    name: 'Jan de Vries',
    type: 'business',
    company_name: 'De Vries Bouw',
  }),
});
const { data: customer } = await response.json();
Python
response = requests.post(
    "https://app.klantly.com/api/v1/customers",
    headers={
        "Authorization": f"Bearer {os.environ['KLANTLY_API_KEY']}",
        "Idempotency-Key": "6f1c2d3e-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
    },
    json={
        "email": "jan@example.com",
        "name": "Jan de Vries",
        "type": "business",
        "company_name": "De Vries Bouw",
    },
)
customer = response.json()["data"]

La réponse est 201 Created avec le nouveau client. Le client apparaît immédiatement dans Klantly, avec une entrée dans l'historique client, et les automatisations que vous avez configurées se déclenchent.

4. Étapes suivantes

Dernière mise à jour le 14 septembre 2026