Platform and security

API and webhooks

Let your own software work with your CRM data, and keep other systems up to date with webhooks.

Book a demo All features

Connect Henkan CRM to your own systems.

The API lets your own software read and write your CRM data. Webhooks let other systems know the moment something happens in Henkan CRM, and let other systems send leads in, without anyone doing it by hand.

Together they connect Henkan CRM to your website, your automation tools such as Zapier, Make and n8n, and anything you build yourself. Every key and every delivery can be controlled and checked.

Used by
Admins and Managers set up webhooks. Admins generate API keys.
Part of
Platform and security
Set up by
Your admin, in Settings, under Integrations.

From a system to a connection.

  1. Choose the direction Do you want to send data in, get events out, or read and write through the API?
  2. Create the connection Make an endpoint, or generate a key, in Settings.
  3. Point your tool at it Paste the address or key into Zapier, Make, n8n or your own code.
  4. Test it Send a test and check that it arrives.
  5. Let it run Data flows in and out as things happen.
  6. Keep an eye on it Check the delivery logs, and disable a key at any time.

Everything about the API and webhooks.

Each part, what it does and how to use it.

01

API keys

Let another system read or write your CRM data.

Generated by Admins

Read only, or read and write
Give each key just the access it needs.
One key per system
Give each key a name, so you know which system uses it.
Shown once
A key is displayed once when you create it, so copy it straight away. It is never shown again.
Sent as a bearer token
Your system sends the key in an authorisation header with each request.
In your control
Disable a key at any time, and delete it once it is disabled. A table shows when each key was last used.

How to use it

  1. Go to Settings, Integrations, then API Keys.
  2. Click Generate Key, give it a name and choose Read only or Read and write.
  3. Copy the key immediately and store it safely.

Next: Inbound webhooks

02

Inbound webhooks

Send leads into Henkan CRM from your website or any other tool.

An address for each source
Create an endpoint with a name, a lead source and a key. Create as many as you need, such as one for Contact Form 7 and one for Facebook Lead Ads.
Works with your tools
Paste the web address into your form builder, or into Zapier, Make or another automation tool.
Map the fields
Send a test, then match each incoming field to a CRM field, such as company, email and phone.
Assigned like any lead
Round-robin assignment applies when it is switched on for the source.

How to use it

  1. Go to Settings, Integrations, then Website Forms.
  2. Create an endpoint, copy its web address and paste it into your tool.
  3. Submit a test, then map the fields and save.

More about capture

Next: Outbound webhooks

03

Outbound webhooks

Tell another system the moment something happens.

Events you choose
Choose from events such as a lead being created or archived, a deal being created, won, lost or moved to another stage, a proposal being sent, accepted or declined, and a booking being created or cancelled.
Your own endpoint
Send them to Zapier, Make, n8n or an address of your own.
Signed
Each delivery is signed, so your system can check that it really came from Henkan CRM.
A consistent payload
Every payload carries a schema version, the event, when it fired, your account and the data.
Easy to test
Send a sample payload from the endpoint, and view the delivery log to see what was sent.

How to use it

  1. Go to Settings, Integrations, then Outbound Webhooks.
  2. Create an endpoint with a name, an HTTPS address, a secret key and the events you want.
  3. Click Test to send a sample payload.

Next: Zapier, Make and n8n

04

Zapier, Make and n8n

Connect hundreds of other tools, without writing code.

Leads in
Use an inbound webhook so that anything your automation tool captures becomes a lead.
Events out
Use an outbound webhook so that your automation tool reacts when a deal is won or a proposal is accepted.
No code
You connect them with addresses and keys, so most setups need no code at all.

How to use it

  1. In your automation tool, add a webhook step.
  2. Paste the address from Henkan CRM, or give it yours.

More about integrations

Next: Checking and logging

05

Checking and logging

See what was sent, and fix what failed.

A delivery log
Each outbound endpoint has its own delivery log.
The sync log
The integrations sync log records inbound and outbound events, and you can filter by direction, provider or result.
Failures are clear
Failed rows show the error and link to the affected lead, so you can fix the data and retry.

How to use it

  1. Open the endpoint to see its delivery log.
  2. Open the sync log at the bottom of Integrations to see everything.

Benefits

What the API and webhooks give your team.

  1. 01

    Connect anything.

    If a tool can send or receive a webhook, or call an API, it can work with Henkan CRM.

  2. 02

    In real time.

    Other systems hear about events as they happen, and leads arrive the moment they are submitted.

  3. 03

    Under your control.

    Choose the access each key has, switch keys off at any time and check every delivery.

  4. 04

    No code needed.

    Use Zapier, Make or n8n to connect other tools without writing anything.

Who uses the API and webhooks.

Questions about the API and webhooks.

Who can create an API key?

Admins. You choose a name and whether the key is read only or read and write.

Can I see an API key again after I create it?

No. It is shown once, so copy it when you create it. You can generate a new one at any time.

What events can I send out?

A lead being created or archived, a deal being created, won, lost or moved to another stage, a proposal being sent, accepted or declined, and a booking being created or cancelled.

How do I know a webhook really came from Henkan CRM?

Every delivery is signed, so your system can verify it.

Can I use Zapier or Make?

Yes. Use inbound webhooks to send leads in, and outbound webhooks to send events out.

Can I turn a key off?

Yes. Disable it at any time, and delete it once it is disabled.

All of Platform and security

See the group
  1. 01Integrations
  2. 02API and webhooksYou are here
  3. 03Roles, permissions and audit trail
  4. 04Data protection tools

See Henkan CRM connected to your systems.

Book a demo and we will show you how leads and events move in and out.

Book a demo
  1. 01 Book a demo Tell us a little about your business.
  2. 02 See it around how you sell We show you the product with your sales process in mind.
  3. 03 We set it up for you Our team configures your account, from fields and stages to automations.