Klantly Developers

Schnellstart

Von einem neuen API-Schlüssel zu Ihrem ersten Kunden über die API, in fünf Minuten.

1. Erstellen Sie einen API-Schlüssel

Gehen Sie in Klantly zu Integrationen → API und wählen Sie Neuer Schlüssel. Geben Sie dem Schlüssel einen Namen, wählen Sie Vollzugriff und klicken Sie auf Schlüssel erstellen. Kopieren Sie den Schlüssel sofort: Sie sehen ihn danach nie wieder.

Warnung

Legen Sie einen Schlüssel nie im Code einer Website oder App ab. Bewahren Sie ihn auf Ihrem Server auf, zum Beispiel in einer Umgebungsvariable.

Terminal
export KLANTLY_API_KEY="kly_..."

2. Testen Sie Ihre Verbindung

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"])

Ist alles in Ordnung, erhalten Sie Ihren Schlüssel, Ihr Unternehmen und Ihre Limits zurück. Erhalten Sie einen Fehler? Dann sehen Sie bei den Fehlercodes nach.

3. Erstellen Sie Ihren ersten Kunden

Senden Sie ein POST an /customers mit mindestens einer E-Mail-Adresse:

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"]

Die Antwort ist 201 Created mit dem neuen Kunden. Der Kunde erscheint sofort in Klantly, mit einem Eintrag in der Kundenhistorie, und die von Ihnen eingerichteten Automationen werden ausgelöst.

4. Nächste Schritte

Zuletzt aktualisiert am 14. September 2026