Klantly Developers

Make and n8n

Connect Klantly to hundreds of other apps without writing code, with Make or n8n.

With Make and n8n you build integrations by clicking blocks together. Klantly works with both, through two building blocks: a webhook to hear that something happened, and an HTTP request to do something in Klantly.

Before you start

In Klantly, create a separate key for Make or n8n under Integrations → API, with only the scopes your scenario needs. That way you can revoke it later without stopping other integrations.

Starting with an event from Klantly

Make

  1. Create a new scenario and choose Webhooks → Custom webhook as the first module.
  2. Add a new webhook and copy the address Make shows.
  3. In Klantly, under Integrations → API, Webhooks tab, create an endpoint with that address and choose the events you need.
  4. Make now waits for a first message to learn which data it contains. Trigger a real event, for example by creating a test customer. The ping test message has a different shape than the real events.

n8n

  1. Add a Webhook node and set the HTTP method to POST.
  2. Use the Production URL as the address of the endpoint in Klantly. The Test URL only works while you are waiting for a test message in the editor.
  3. Activate the workflow.

The object is in the message under data.object; in n8n that is body.data.object. The object in the API reference shows which fields there are. The event type is in type.

Warning

Make and n8n do not check Klantly's signature. So keep the webhook address secret: anyone who knows it can send messages to it. For sensitive actions, process the messages on your own server that checks the signature. Webhooks explains how.

Doing something in Klantly

Make

Use the HTTP → Make a request module:

Setting Value
URL for example https://app.klantly.com/api/v1/customers
Method POST
Headers Authorization with the value Bearer kly_…
Body type Raw, with content type JSON (application/json)
Request content the JSON, for example {"email": "jan@example.com", "name": "Jan de Vries"}
Parse response on

n8n

Use the HTTP Request node:

  1. Under Authentication, choose Generic Credential Type and then Header Auth. Create a credential with the name Authorization and the value Bearer kly_…. That way the key is not stored in the workflow itself.
  2. Choose the method and the URL, for example POST and https://app.klantly.com/api/v1/customers.
  3. Turn on Send Body, with JSON as the content type.

Example: a won deal in Slack

  1. Start with a webhook for the deal.won event.
  2. Fetch the customer with an HTTP request: GET https://app.klantly.com/api/v1/customers/<customer_id>, with customer_id from the event.
  3. Use the Slack module to post a message in your sales channel, with the title and value of the deal and the name of the customer.

Tips

  • Send an Idempotency-Key when creating something, for example the id of the event that started the scenario. If Make or n8n runs a step again, no duplicate record is created.
  • A scenario that processes thousands of records at once can run into the rate limits. Let it wait and try again on 429.
  • An error from Klantly always has a fixed code. The error codes explain per code what you can do about it.

Last updated on September 15, 2026