Setting up webhooks

Article Number:040600

By using webhooks in Kintone, you can have specified external services receive information on specific actions when they are carried out on Kintone apps.
For example, you can make it so records are automatically posted in a chat service when they are added to Kintone. Integrations like this can be configured without writing a program.

How webhooks work

By using an integration tool that enables the use of webhooks, you can connect Kintone to services supported by the tool.
Examples of such tools are Zapier, Microsoft Power Automate, and IFTTT.

イラスト:Webhookの仕組み

By setting up webhooks on a Kintone app, you can set notifications for the following app actions.

  • Adding a record
  • Editing a record
  • Deleting a record
  • Posting a comment
  • Updating the status (When the process management status is updated)

For details on parameters used in webhook notifications that are triggered by actions on Kintone, refer to the following page:
Content of webhook notifications triggered by actions on Kintone

Overview of setting up a webhook

You can set up a webhook by following the steps below.

(1)  Set up a trigger using an integration tool (e.g. Zapier)
(2)  Set up a webhook on Kintone
(3)  Set up an action using the integration tool

Example settings

This section provides an example of using Zapier to set up a webhook that sends a notification to a Gmail account when a new record is added on Kintone.

Preparations

Before setting up a webhook, make the following preparations.

  • Create a Gmail account
  • Create a Kintone app

When your Gmail account and kintone app are ready, follow the steps described below.

1) Setting up a trigger on Zapier

  1. Access the Zapier website and sign up.
    If you already have a Zapier account, click Log in to log in to your account.
    Zapier website

  2. Click Create Zap on the Zapier website.

  3. On the screen to choose a trigger, enter "Webhook" in the search box and click Webhooks by Zapier.スクリーンショット:Webhookのトリガーを選択している

  4. Select Catch Hook under Event and then click Continue.スクリーンショット:[Catch Hook]を選択している

  5. On the screen that follows, click Continue.スクリーンショット:Eventを選択したあとの画面が表示されている

  6. When a webhook URL is generated, click Copy.
    Paste the copied URL somewhere at hand, such as a text editor.スクリーンショット:[Copy]を枠線で強調している

Next, you will set up a webhook on Kintone. Keep the Zapier website open.

2) Set up a webhook on Kintone

  1. Click the App settings icon (the gear-shaped icon) at the upper right of the View screen.
    スクリーンショット:[アプリを設定]アイコンが枠線で強調されている

  2. On the App settings screen, select the App settings tab, and then click Webhooks under Customization and integration.

  3. On the Webhooks screen, click Add webhook.

  4. On the New webhook screen, enter a description of the webhook to be set.
    The description you enter here will be displayed in the list of webhooks. You can enter up to 64 characters.

  5. In the Webhook endpoint input field, paste the URL you have copied in Step 6 of the "Setting up a trigger on Zapier" section.
    Setting up a trigger on Zapier
    Delete "https://" at the beginning of the URL.
    You can enter up to 1,024 characters in the input field.スクリーンショット:[Webhookの追加]画面が表示されている

  6. In the Events section, specify the actions that will trigger a webhook notification.
    In this example, select Record is added.スクリーンショット:[通知を送信する条件]が表示されている

  7. Make sure the Activate this webhook checkbox is selected.
    The checkbox is selected by default.

  8. Click Save at the bottom right of the screen.

  9. On the Webhooks screen, click App settings in the message displayed at the top of the screen or click Back to app settings displayed at the bottom left of the screen.

  10. On the App settings screen, click Update app.

  11. On the Update app dialog, click Update app.

  12. Add a new record on the Kintone app so that you can test the trigger you have set up on Zapier.

  13. Return to the Zapier website and click Test trigger.
    スクリーンショット:[Test trigger]が表示された画面

  14. Check that the test is successful. Then, click Continue with selected record.
    If the test fails, try Test trigger several times.
    If the test still fails, check that the URL you copied and pasted in theWebhook endpoint input field is correct.

3) Setting up an action on Zapier

  1. When the screen to set up an action is displayed in Zapier, select Gmail.
    スクリーンショット:[Gmail]が枠線で強調されている

  2. Select Send Email under Event and then click Continue.
    スクリーンショット:[Event]に[Send Email]が選択されている

  3. Select a Gmail account and then click Continue.
    If you haven't signed in to Gmail, a screen appears for you to sign in to Gmail.スクリーンショット:Gmailのアカウントを選択している

  4. Specify the information to be sent to the Gmail account.
    Enter the Gmail account of the recipient into the  To section, and set up other necessary items including the Subject and Body sections. Then, click Continue.
    スクリーンショット:Gmailに通知する内容を設定している

  5. Confirm the setting you have set up and click Test & continue.

  6.  Click Publish Zap.

  7. Check that the notification email is sent to the recipient's Gmail account, and click Publish & Turn On.

The Zap is now valid.

Changing the settings of a webhook in Kintone

Webhook settings in Kintone can be changed later on. The steps are as follows.

  1. Click the App settings icon (the gear-shaped icon) at the upper right of the View screen.
    スクリーンショット:[アプリを設定]アイコンが枠線で強調されている

  2. On the App settings screen, select the App settings tab, and then click Webhooks under Customization and integration.

  3. On the Webhooks screen, click the Edit icon in the far right column of the webhook for which you want to change the settings.
    スクリーンショット:[編集]を枠線で強調している

  4. On the Edit webhook screen, edit the settings and click Save.

  5. On the Webhooks screen, click App settings in the message displayed at the top of the screen or click Back to app settings displayed at the bottom left of the screen.

  6. On the App settings screen, click Update app.

  7. On the Update app dialog, click Update app.