Setting Webhook

By using Webhook in kintone, a certain action you performed in the kintone app can be sent to a specified external service .
For example, you can set up integrations without writing a program, such as posting the contents of newly added record to a chat service.
Webhook is available only for kintone Standard Course.

How Webhook Works

By specifying a tool that help you integrate Webhook with different services as a target service, you can link kintone with various kinds of services that the tool supports.
As a tool that supports the integration, you can use Zapier, Microsoft Power Automate, and IFTTT and so on.

Image

Once Webhook is configured, a notification is sent when the following actions are performed in the kintone apps.

  • Add records
  • Edit records
  • Deleting records
  • Posting Comments
  • Updating process management statuses

For parameters on the notifications triggered by the actions in kintone, see "Content of Webhook Notification Triggered by Actions in kintone".

Example

In this section, we use Zapier to show you an example of "sending a notification to Gmail when a new record is added to kintone".

Preparations

Before configuring a Webhook integration, you need to do the following for preparation:

  • Create a Gmail account
  • Create an app in kintone

When the preparation is complete, perform the following configurations.

Configuring a Trigger in Zapier

  1. Access the Zapier website to sign up.
    If you do not have a Zapier account, create a new one or sign up with a supported account such as Google account.

  2. Click MAKE A ZAP on the Zapier website.

  3. Enter a name in the "Name your zap".

  4. On the screen to choose a trigger, enter "Webhook" in the search box and click "Webhooks by Zapier".

  5. Select "Catch Hook" in the Trigger Event, and click CONTINUE.

  6. After a Custom Webhook URL is created, click Copy.
    Copy the URL and paste it somewhere like a text editor.

Configuring a Webhook in kintone

  1. Open the Webhook setting page in kintone.
    Click the app settings button Setting button on the upper right of the View, select the "Customization and Integration" in the"App Settings" tab, and select Webhooks.

  2. Click the add button Image.

  3. Enter the description of Webhook to configure.
    The description you enter here will be displayed in the list of Webhook settings. You can enter up to 64 characters. Image

  4. In the Webhook Endpoint field, paste the URL that you copied in Step 6 of "Configuring a Trigger in Zapier"section. Delete "https://" from the pasted URL because it is unnecessary.
    You can enter up to 1,024 characters in the URL field.

  5. In the Events, specify an action for sending the Webhook notification.
    In this example, select "Record is added".

  6. Select whether to enable the Webhook that was set. By default, this is enabled.

  7. Click Save.

  8. Click Back to App Settings on the bottom right side of the Webhook screen.

  9. Click Update App on the upper right of the App Settings screen, and click OK.

  10. To test the trigger configured in Zapier, add a new record in the kintone app.

  11. Return to the Zapier website, click CONTINUE, and click Test trigger.

  12. After you confirmed that the test completed successfully, click CONTINUE.
    If the test failed, try Test trigger several times.
    If the test still fails, check if the URL you copied and pasted in the Webhook Endpoint is correct.

Configure an Action in Zapier

  1. In Zapier, select Gmail on the action setting page.

  2. Select "Send Email" in the Action Event and click CONTINUE.

  3. Select a Gmail account and click CONTINUE.
    If you haven't logged in to Gmail, a screen to confirm your login permission appears.

  4. Configure what kind of information you want to send to Gmail. Enter a Gmail address of the recipient in "To", and configure other necessary information including subject and body.
    After you complete the setting, click CONTINUE.

  5. After you confirmed the setting you made, click TEST & CONTINUE.

  6. Check if the notification e-mail is sent to the recipient's Gmail, and click TURN ON ZAP.

  7. Enable the Zap you configured by turning it on.

Changing the Settings of a Webhook in kintone

  1. Click the edit button Edit button for the Webhook whose setting you want to change.
    Changing the settings of Webhook

  2. Click Back to App Settings on the bottom right side of the Webhook screen.

  3. Click Update App on the upper right of the App Settings screen, and click OK.

Deleting the Settings of a Webhook in kintone

  1. Click the Delete button Delete button for the Webhook you want to delete, and click Delete. Deleting Webhook
  2. Click Back to App Settings on the bottom right side of the Webhook screen.
  3. Click Update App on the upper right of the App Settings screen, and click OK.