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.
- Choose the direction Do you want to send data in, get events out, or read and write through the API?
- Create the connection Make an endpoint, or generate a key, in Settings.
- Point your tool at it Paste the address or key into Zapier, Make, n8n or your own code.
- Test it Send a test and check that it arrives.
- Let it run Data flows in and out as things happen.
- 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.
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
- Go to Settings, Integrations, then API Keys.
- Click Generate Key, give it a name and choose Read only or Read and write.
- Copy the key immediately and store it safely.
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
- Go to Settings, Integrations, then Website Forms.
- Create an endpoint, copy its web address and paste it into your tool.
- Submit a test, then map the fields and save.
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
- Go to Settings, Integrations, then Outbound Webhooks.
- Create an endpoint with a name, an HTTPS address, a secret key and the events you want.
- Click Test to send a sample payload.
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
- In your automation tool, add a webhook step.
- Paste the address from Henkan CRM, or give it yours.
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
- Open the endpoint to see its delivery log.
- Open the sync log at the bottom of Integrations to see everything.
Benefits
What the API and webhooks give your team.
-
01
Connect anything.
If a tool can send or receive a webhook, or call an API, it can work with Henkan CRM.
-
02
In real time.
Other systems hear about events as they happen, and leads arrive the moment they are submitted.
-
03
Under your control.
Choose the access each key has, switch keys off at any time and check every delivery.
-
04
No code needed.
Use Zapier, Make or n8n to connect other tools without writing anything.
Who uses the API and webhooks.
-
Owners
Know your CRM is connected to the rest of your business, without relying on manual work.
Henkan CRM for owners -
Managers
Set up webhooks and connections to the tools your team uses.
Henkan CRM for managers -
Sales reps
Benefit from leads that arrive on their own, and events that trigger the right follow-up.
Henkan CRM for sales reps
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.
