Join the program

Webhooks

Last Updated:
Follow

Introduction

This article is an introduction to setting up Webhooks in Kintone. You can utilize the Webhook feature to connect to services outside of Kintone.

What are Webhooks?

In Kintone, each App has an option to set up Webhooks.
The Kintone Webhook feature allows data of a record of an App to be sent to a particular endpoint in a certain format. This data can be sent at the following timings:

  • When a new record is added
  • When a record is saved after editing
  • When a record is deleted
  • When a user posts a comment to a record
  • When a process management status is updated

Why set up a Webhook?

The Kintone Webhooks is a good way to send data to an endpoint without the use of coding. Setting up a webhook will only involve stating an endpoint, and the timing for the data to be sent.
It is also necessary to set up the endpoint side so that the data can be caught and used. To do this without coding, a cloud service like Zapier can be used to catch the Kintone Webhook data, and connect it to other services.

How to set up a Webhook

First, confirm the field settings. When Kintone sends out data using the Webhook feature, the Field Codes are sent to the endpoint rather than Field names.
Make sure to change the Field Code of the fields of the App, so the field codes and field names can be matched easier later on.

 

Once that's done, follow these steps to set up the Webhook:

  1. In the App Settings, click on "Webhooks".
  2. Click on the [+] sign to add a new Webhook setting.
  3. Set a name for the Webhook. This is just giving it a name to identify it later on. This can be set to anything.
  4. Set a Webhook Endpoint. This should be in a form of a URL, and should be generated by the service that to connect to. For example, for Webhooks by Zapier Integrations, a Webhook URL should be generated by Zapier during one of the steps for setting up the Zap.
  5. Select an Event (or timing) for when the data should be sent to the Webhook endpoint.
  6. Keep the Activation checkbox checked. This can be un-check at any time to stop sending data to the Webhook endpoint.
  7. Click Save when done.
  8. Click on Back to App Settings and then Update App to deploy these settings to the App. webhook_setup.png

Now whenever the selected event occurs, data from the record will be sent to the Endpoint URL.

Data sent by the Webhook

The Kintone record data sent by the Webhooks are as follows:

Events: Record is added / Record is edited / Status is changed

Parameter Type Details
id String A unique ID given to the webhook notification.
type String The event type.
Record is added: ADD_RECORD
Record is edited: UPDATE_RECORD
Status is changed: UPDATE_STATUS
app Array An array consisting of App data.
app[].id String The App ID.
app[].name String The App name.
record Array An array consisting of record data.
The format is the same as what the Get Record REST API uses:
recordTitle String The Title Field of the record.
Title Fields of records can be edited in the App's settings.
url String The URL of the record.

Events: Record is deleted

Parameter Type Details
id String A unique ID given to the webhook notification.
type String The event type.
Record is deleted: DELETE_RECORD
app Array An array consisting of App data.
app[].id String The App ID.
app[].name String The App name.
recordId String The record number.
deleteBy Array An array consisting of data of the user who deleted the record.
deleteBy[].code String The User Code (log in name).
deleteBy[].name String The User's display name.
deleteAt String The date and time of when the record was deleted.

Events: Comment is posted

Parameter Type Details
app Array An array consisting of App data.
app[].id String The App ID.
app[].name String The App name.
comment Array An array consisting of comment data.
The format is the same as what the Get Comments REST API uses.
id String A unique ID given to the webhook notification.
recordId String The record number.
type String The event type.
Comment is posted： ADD_RECORD_COMMENT
url String The URL of the comment.

Cloud services for Webhook Endpoints

There are several cloud services that can be set as the Endpoints:

Was this article helpful?
2 out of 4 found this helpful
Do you have any questions or issues related to this article?
Please share your views with us in the Community forums!