Klantly Developers

Snelstart

Van een nieuwe API-sleutel naar je eerste klant via de API, in vijf minuten.

1. Maak een API-sleutel

Ga in Klantly naar Integraties → API en kies Nieuwe sleutel. Geef de sleutel een naam, kies Volledige toegang en klik op Sleutel aanmaken. Kopieer de sleutel direct: je ziet hem daarna nooit meer.

Waarschuwing

Zet een sleutel nooit in de code van een website of app. Bewaar hem op je server, bijvoorbeeld in een omgevingsvariabele.

Terminal
export KLANTLY_API_KEY="kly_..."

2. Test je verbinding

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

Klopt alles, dan krijg je je sleutel, je bedrijf en je limieten terug. Krijg je een fout? Kijk dan bij de foutcodes.

3. Maak je eerste klant

Stuur een POST naar /customers met minimaal een e-mailadres:

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

Het antwoord is 201 Created met de nieuwe klant. De klant staat meteen in Klantly, met een regel op de klanttijdlijn, en de automations die je hebt ingesteld gaan af.

4. Volgende stappen

Laatst bijgewerkt op 14 september 2026