Webhookとは
kaonavi Webhook とは、以下のイベントが発生した際に、指定したURLへHTTPリクエスト（通知）を送信する機能です。
- メンバーの登録（member_created）
- メンバーの更新（member_updated）※基本情報・兼務情報・シートの更新が対象
- メンバーの削除（member_deleted）
Webhookを利用することで、カオナビ上のデータ変更をリアルタイムに検知し、他システムとの連携や自動化を実現できます。
注意事項は以下のとおりです。
- 再計算によるメンバーの基本情報の更新は対象外です。
- Webhookの対応機能についてはこちらをご確認ください。
WebhookをAPIから設定する
Webhookの設定は「Webhook設定API」から可能です。
設定方法はこちらのAPIドキュメントをご覧ください。
Webhookを画面から設定する
①『Webhookを追加』をクリックする
「設定」をクリックし、『Webhookを追加』をクリックします。
設定済みのWebhookについては以下の通りです。
- 鉛筆マーク：追加済みの Webhook を編集できます。
- ゴミ箱マーク：追加済みの Webhook を削除できます。
②Webhookを設定する
URL、イベント、検証用トークンを入力し、『保存』ボタンをクリックします。
基本情報・兼務情報と、シートの Webhook を区別して処理を行う場合
基本情報・兼務情報と、シートの Webhook を区別して処理を行いたい場合は、ペイロード内の resource_type を用いることで見分けることが可能です。
（例）基本情報・兼務情報の更新時のペイロード
{
"event": "member_updated",
"event_time": "2026-03-10T10:00:00+09:00",
"resource_type": "member",
"sheet_id": null,
"member_data": [
{ "code": "A001" },
{ "code": "A002" }
]
}（例）シートの更新時のペイロード
{
"event": "member_updated",
"event_time": "2026-03-10T10:00:00+09:00",
"resource_type": "sheet",
"sheet_id": 12,
"member_data": [
{ "code": "A001" },
{ "code": "A002" }
]
}Webhookの送信履歴を確認する
「送信履歴」をクリックすると、Webhook を送信した履歴（ログ）を確認できます。