Klantly Developers

Make en n8n

Koppel Klantly zonder te programmeren aan honderden andere apps, met Make of n8n.

Met Make en n8n bouw je koppelingen door blokken aan elkaar te klikken. Klantly werkt met allebei, via twee bouwstenen: een webhook om te horen dat er iets gebeurt, en een HTTP-verzoek om iets in Klantly te doen.

Voordat je begint

Maak in Klantly onder Integraties → API een aparte sleutel voor Make of n8n, met alleen de scopes die je scenario nodig heeft. Zo kun je hem later intrekken zonder dat andere koppelingen stoppen.

Starten met een event uit Klantly

Make

  1. Maak een nieuw scenario en kies als eerste module Webhooks → Custom webhook.
  2. Maak een nieuwe webhook aan en kopieer het adres dat Make toont.
  3. Maak in Klantly onder Integraties → API, tabblad Webhooks, een endpoint met dat adres en kies de events die je nodig hebt.
  4. Make wacht nu op een eerste bericht om te leren welke gegevens erin staan. Zorg voor een echt event, bijvoorbeeld door een testklant aan te maken. Het testbericht ping heeft een andere vorm dan de echte events.

n8n

  1. Voeg een Webhook-node toe en zet de HTTP-methode op POST.
  2. Gebruik de Production URL als adres van het endpoint in Klantly. De Test URL werkt alleen zolang je in de editor op een testbericht wacht.
  3. Activeer de workflow.

Het object staat in het bericht onder data.object; in n8n is dat body.data.object. Welke velden er zijn, zie je bij het object in de API-referentie. Het type event staat in type.

Waarschuwing

Make en n8n controleren de handtekening van Klantly niet. Houd het webhookadres daarom geheim: wie het kent, kan er berichten naartoe sturen. Gaat het om gevoelige acties, verwerk de berichten dan op een eigen server die de handtekening controleert. Hoe dat werkt, lees je in Webhooks.

Iets in Klantly doen

Make

Gebruik de module HTTP → Make a request:

Instelling Waarde
URL bijvoorbeeld https://app.klantly.com/api/v1/customers
Method POST
Headers Authorization met de waarde Bearer kly_…
Body type Raw, met content type JSON (application/json)
Request content de JSON, bijvoorbeeld {"email": "jan@example.com", "name": "Jan de Vries"}
Parse response aan

n8n

Gebruik de node HTTP Request:

  1. Kies bij Authentication voor Generic Credential Type en daarna Header Auth. Maak een credential met als naam Authorization en als waarde Bearer kly_…. Zo staat de sleutel niet in de workflow zelf.
  2. Kies de methode en de URL, bijvoorbeeld POST en https://app.klantly.com/api/v1/customers.
  3. Zet Send Body aan, met JSON als content type.

Voorbeeld: een gewonnen deal in Slack

  1. Start met een webhook voor het event deal.won.
  2. Haal de klant op met een HTTP-verzoek: GET https://app.klantly.com/api/v1/customers/<customer_id>, met customer_id uit het event.
  3. Stuur met de Slack-module een bericht naar je verkoopkanaal, met de titel en de waarde van de deal en de naam van de klant.

Tips

  • Stuur bij aanmaken een Idempotency-Key mee, bijvoorbeeld de id van het event waarmee het scenario begon. Voert Make of n8n een stap opnieuw uit, dan ontstaat er geen dubbel record.
  • Een scenario dat duizenden records in één keer verwerkt, kan tegen de rate limits aanlopen. Laat het bij 429 wachten en het opnieuw proberen.
  • Een fout van Klantly heeft altijd een vaste code. In de foutcodes staat per code wat je eraan kunt doen.

Laatst bijgewerkt op 15 september 2026