---
title: "kickflowとは？料金の決まり方とREST API・Webhookで他システムと連携する実装手順"
url: "https://www.issoh.co.jp/tech/details/20106/"
published: 2026-11-23
updated: 2026-11-23
categories: ["業務システム"]
publisher: "株式会社一創"
---

# kickflowとは？料金の決まり方とREST API・Webhookで他システムと連携する実装手順

kickflow（キックフロー）は、株式会社kickflowが提供するクラウドワークフローで、申請・承認・回覧の流れを「チケット」として扱います。料金は初期費用0円、月額はプランとID数で個別見積りになり、契約は50IDからです。外部システムとはREST API（`https://api.kickflow.com/v1/`）とWebhookでつなげます。本記事では、kickflowのデータの単位と経路設定の考え方、料金の決まり方と2プランの上限値、APIの認証と利用制限、チケット作成と承認通知の受け取りを、2026年11月時点の公式ドキュメントに沿って実装の手順で解説します。

## まとめ：kickflowを選ぶ条件とAPI・Webhook連携で先に決めておくこと

kickflowが向くのは、50ID以上の規模で、組織改編が多く、承認結果を会計・人事・SaaSなど他のシステムへ流したい企業です。組織図をバージョンで管理でき、経路は役職や組織から承認者を引く形で設定するため、異動のたびに経路を作り直す手間を抑えられます。

連携の入口は2つです。kickflowを外から操作するならREST API、kickflowで起きたことを外へ知らせるならWebhookを使います。REST APIは送信元IPアドレスごとに毎分30回まで、Webhookはタイムアウト10秒・最大10回の再送という制約があり、どちらも設計の前提になります。

料金は公開価格がなく見積り制です。オートメーションの実行回数（月100回と月10,000回）や監査ログの保存期間（60日と1年）などの上限がプランで分かれるので、連携の件数を先に見積もってからプランを決めます。従業員が50人に満たない会社や、承認経路が1〜2段で変わらない会社には過剰です。

## kickflowの機能構成と申請・承認の経路をクラウドで一元化する仕組み

APIで連携する前に、kickflowがどんな単位でデータを持っているかを押さえておくと、エンドポイントの読み方で迷いません。

### チケット・ワークフロー・経路・組織図の4つで構成されるデータの単位

kickflowの公開OpenAPI定義（[kickflow REST API v1のschema.yaml](https://developer.kickflow.com/rest/schema.yaml)、OpenAPI 3.1）を見ると、中心になるリソースは次の4つです。

| リソース   | 役割        | 主なエンドポイント              |
| ------ | --------- | ---------------------- |
| チケット   | 1件の申請そのもの | /v1/tickets            |
| ワークフロー | 申請書の様式と設定 | /v1/workflows          |
| 経路     | 承認・回覧の順序  | /v1/routes             |
| 組織図    | チームと所属・役職 | /v1/organizationCharts |

申請者は「ワークフロー」を選んでチケットを作り、チケットは「経路」に沿って承認者へ回ります。承認者を決める基準は、「組織図」に登録されたチームや役職です。このほか、選択肢の候補を持つ汎用マスタ（/v1/generalMasters）、代理申請・代理承認（/v1/proxyApplicants・/v1/proxyApprovers）、監査ログ（/v1/auditLogs）もAPIから扱えます。

### 組織図のバージョン管理で4月の組織改編に経路を追従させる設計

ワークフロー製品の運用で手間がかかるのは、異動や組織改編のたびに承認経路を直す作業です。kickflowは組織図を複数持ち、どれを有効にするかを切り替えられます。APIにも組織図を有効化するエンドポイント（`POST /v1/organizationCharts/{organizationChartId}/activate`）があり、翌期の組織図を事前に作っておいて、4月1日に切り替える運用ができます。

人事システムを正としている会社なら、人事システムの組織データからチームと所属をAPIで登録し、切り替えだけを人が確認する形にすると、両方のシステムで同じ組織データを手作業でメンテナンスする必要がありません。経路は「部長」「経理担当」のように役職やチームで承認者を指定しておくと、所属が変わっても経路の定義は直さずに済みます。ワークフローシステム全般の機能と選び方は[ワークフローシステムの機能とクラウド・オンプレの違い](https://www.issoh.co.jp/column/details/15254/)で整理しています。

## kickflowの料金が2プラン・50IDから個別見積りで決まる仕組みと上限値

kickflowの[公式の料金ページ](https://kickflow.com/pricing)には、2026年11月時点で月額の金額は載っていません。初期費用0円、月額はプランとID数に応じた個別見積り、契約は50IDから、という決まり方だけが示されています。

### スタンダードとエンタープライズで変わる上限値とSSO・帳票出力の有無

プランはスタンダードとエンタープライズの2つです。連携の設計に関わる上限値は次のとおりです（2026年11月時点の料金ページより）。

| 項目             | スタンダード | エンタープライズ  |
| -------------- | ------ | --------- |
| オートメーション実行     | 100回/月 | 10,000回/月 |
| フィールド数         | 100    | 200       |
| 管理者ロール         | 10     | 100       |
| 監査ログ保存期間       | 60日    | 1年        |
| バックアップ         | 3日前まで  | 7日前まで     |
| SSO・IPアドレス制限   | なし     | あり        |
| 帳票出力・外部ストレージ連携 | なし     | あり        |

見落としやすいのはオートメーションの実行回数です。月100回は、1日5件の申請に1回ずつ自動処理を走らせるだけで使い切る水準です。社内の申請が月数百件あり、その都度自動で何かを動かすなら、エンタープライズか、kickflowの外（Webhookを受けた自社の仕組み）で処理する設計になります。監査ログを1年残す社内規程がある会社も、スタンダードでは足りません。

### 見積り前に決めておくID数・連携件数と30日間の無料トライアルの使い方

料金ページによると、30日間の無料トライアルはエンタープライズ相当の環境で使え、トライアル中に作った申請フォーム・承認経路・組織図は契約後もそのまま引き継げます。アカデミック・ガバメント向けの特別価格もあります。

見積りを正確にするには、依頼の前に次の3つを数えておきます。申請・承認に関わる人数（ID数）、月間の申請件数と、そのうち他システムへ連携する件数、SSOや監査ログ1年保存の要否です。トライアル期間は画面の使い勝手を見るだけで終えず、後述のAPIとWebhookを実際に呼んで、連携先との受け渡しまで試すと、契約後に「プランの上限で動かない」と分かる事態を防げます。

## kickflow REST APIの認証と利用制限を確かめてチケットを操作する手順

ここからは、kickflowの[REST APIの公式ドキュメント](https://developer.kickflow.com/rest/)に沿って、実際にリクエストを送る手順を示します。エンドポイントは `https://api.kickflow.com/v1/`、Content-Typeは `application/json` のみです。

### 発行ユーザー本人の操作となりすまし操作で使い分ける2種類のトークン

アクセストークンは2種類あります。Personal Access Tokenはトークンを発行したユーザー本人の操作を自動化するもので、Service Account Tokenはテナント内の任意のユーザーになりすまして操作するためのものです。後者は `X-Caller-Id` ヘッダーになりすまし先ユーザーのUUIDを入れて使います。

公式ドキュメントは、Service Account Tokenは漏えいしたときの影響が大きいため、どうしても必要でない限りPersonal Access Tokenを検討するよう求めています。権限はRBACで管理され、トークンで実行できる操作はユーザー（なりすましの場合はなりすまし先）の権限と同じです。権限のない操作は403、認証の失敗は401が返ります。「申請者本人として起票する」連携だけがService Account Tokenの出番で、集計や監視のための読み取りならPersonal Access Tokenで足ります。

### curlでチケット一覧を取得して毎分30回の利用制限の残りを確かめる

最初の疎通確認には、処理中と完了のチケットを取得するリクエストが手軽です。`-i` を付けてレスポンスヘッダーも表示します。

```
# 処理中と完了のチケットを100件ずつ取得する（配列は status[] を繰り返して指定）
curl -i -G "https://api.kickflow.com/v1/tickets" \
  -H "Authorization: Bearer ${KICKFLOW_TOKEN}" \
  -H "Content-Type: application/json" \
  --data-urlencode "status[]=in_progress" \
  --data-urlencode "status[]=completed" \
  --data-urlencode "perPage=100" \
  --data-urlencode "sortBy=updatedAt-desc"

# レスポンスヘッダーで確認する項目
# RateLimit-Remaining … 現在のウィンドウで残っている実行回数
# Link: ...; rel="next" … 次のページのURL（Total ヘッダーに合計件数）
```

REST APIの利用制限は、リクエスト元のIPアドレスごとに毎分30回です。超えると429が返ります。`perPage` の上限は100なので、5,000件のチケットを全件取得すると50リクエストになり、1分では終わりません。`RateLimit-Remaining` と `RateLimit-Reset` を見て待機を入れるか、`updatedAtStart` で前回取得以降の差分だけを取る設計にします。毎分300回まで上限を広げる有償の「REST API利用枠オプション」もあり、契約時に発行されるシークレットを `X-Rate-Limit-Secret` ヘッダーに付けて使います。

### POST /v1/ticketsで申請チケットを作成するJSONのリクエスト例

他システムから申請を起票するには `POST /v1/tickets` を使います。OpenAPI定義で必須とされているのは `status`・`workflowId`・`authorTeamId` の3つで、フォームのあるワークフローでは `inputs` も必須です。

```
# 購買申請を「申請済み（in_progress）」で作成する例
curl -X POST "https://api.kickflow.com/v1/tickets" \
  -H "Authorization: Bearer ${KICKFLOW_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "in_progress",
    "workflowId": "ワークフローのUUID",
    "authorTeamId": "申請チームのUUID",
    "inputs": [
      { "formFieldCode": "item_name", "value": "検証用ノートPC" },
      { "formFieldCode": "amount", "value": 198000 }
    ]
  }'
```

`status` は作成時に `draft`（下書き）か `in_progress`（申請）だけを選べます。`inputs` の各要素はフォームフィールドのUUID（`formFieldId`）かコード（`formFieldCode`）のどちらかで指定し、ワークフローのすべてのフォームフィールドに対応する入力を入れる必要があります。フィールドIDはワークフローを作り直すと変わるため、管理画面でフィールドコードを付けておき、コードで指定するほうが保守が楽です。承認者を申請者が指名する経路ステップがある場合は `approvers` で渡します。承認そのものも `POST /v1/tickets/{ticketId}/approve` で実行でき、承認時のコメントが必須の設定なら `comment` を付けます。

## kickflow Webhookで承認完了を受け取り署名を検証する受信側の実装

承認が終わったら会計システムに仕訳を作る、却下されたら起票元に戻す、といった連携はWebhookで受けます。仕様は[kickflow Webhook APIの公式ドキュメント](https://developer.kickflow.com/webhook/)にまとまっています。

### Webhookの13種類のイベントと10秒のタイムアウト・最大10回の再送

イベントは、設定確認用の `ping`、チケットの作成・編集・申請・承認・確認・差し戻し・却下・完了・取り下げ・アーカイブ（`ticket_created` から `ticket_archived` までの10種）、コメントの作成・編集（`comment_created`・`comment_updated`）があり、`ping` を含めて13種類です。承認の途中段階を拾うなら `ticket_approved`、最終決裁だけを拾うなら `ticket_completed` を使います。

リクエストはPOSTで、タイムアウトは10秒、失敗すると指数バックオフで最大10回再送されます。受信側は200を返す必要があり、300番台（リダイレクト）も失敗扱いです。1週間失敗し続けたWebhookは自動で無効になり、以後は送られてきません。送信元IPアドレスは公式ドキュメントに6つ掲載されており、受信側でIP制限をかける場合は予告の上で変わり得る点を運用手順に入れておきます。

### HMAC-SHA256でWebhookの署名を検証するNode.jsの受信コード

Webhookの設定でシークレットを登録すると、リクエストに `X-Kickflow-Signature` ヘッダーが付きます。値はペイロードのJSON文字列をシークレットでHMAC-SHA256にかけ、先頭に `sha256=` を付けたものです。JSONを解析した後のオブジェクトから作り直すと一致しないので、受け取った生のバイト列で計算します。

```
// Node.js 20 + Express 4 での受信例（npm install express）
const crypto = require("crypto");
const express = require("express");
const app = express();
const handled = new Set(); // 本番では DB の一意制約で管理する

app.post("/kickflow/webhook", express.raw({ type: "application/json" }), (req, res) => {
  const expected = "sha256=" + crypto
    .createHmac("sha256", process.env.KICKFLOW_WEBHOOK_SECRET)
    .update(req.body) // 生のバイト列で計算する
    .digest("hex");
  const received = req.get("X-Kickflow-Signature") || "";
  const valid = received.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));
  if (!valid) return res.status(401).end();

  const deliveryId = req.get("X-Kickflow-Delivery");
  res.status(200).end(); // 10秒以内に先に 200 を返す
  if (handled.has(deliveryId)) return; // 同じイベントの2回目は捨てる
  handled.add(deliveryId);

  const event = JSON.parse(req.body.toString("utf8"));
  if (event.eventType === "ticket_completed") {
    console.log("決裁完了:", event.data.ticket.publicId, event.data.ticket.title);
  }
});

app.listen(3000);
```

このコードは、署名が合わなければ401で拒否し、署名が一致した場合の動作は、先に200を返してからイベントを処理する流れです。重い処理（会計システムへの登録など）を同期で行うと10秒を超えて再送を招くため、本番ではキューに積んで別のワーカーで処理します。署名検証・冪等性・再送の考え方を一般化した実装は[Webhookの作り方と受信側の署名検証・冪等性の実装](https://www.issoh.co.jp/tech/details/1378/)で詳しく扱っています。

### 重複配信と到達順の入れ替わりに備えるDelivery IDとupdatedAtの比較

ここで確認しておきたいのは、公式ドキュメントが受信処理について挙げている2つの注意点です。1つは、タイムアウトした場合に同じイベントが2回届くことがある点で、同じイベントなら `X-Kickflow-Delivery` ヘッダーに同じUUIDが入ります。上のコードの `handled` はこのための仕組みで、本番ではDBに一意制約を張って記録します。

もう1つは、Webhookが複数のサーバーで分散して送られるため、イベントの発生順と到達順が前後することがある点です。チケットの情報を外部のDBへ書き込んでいるなら、ペイロードのチケットの `updatedAt` を比べ、手元より新しい場合だけ上書きします。この2つを入れずに作ると、「差し戻し後に再申請したのに、古い差し戻しの通知で状態が戻る」不整合が起きます。

2026年11月時点の[変更履歴](https://developer.kickflow.com/changelog/)には「今後予定している破壊的変更」として、`ticket_approved`・`ticket_completed`・`comment_created` などのWebhookで `user` が `null` になる場合があると予告されています（適用時期は別途告知）。承認者の名前を `event.user.fullName` から取っているなら、今のうちに `null` を許容する実装にしておきます。

## kickflow連携をiPaaSで済ませるか個別開発するかの判断基準と見送り条件

APIとWebhookがあるからといって、すべての連携を自前で作る必要はありません。件数と処理の複雑さで手段を分けます。

### Workato・YoomのkickflowコネクタやMCPサーバーで足りる連携の範囲

kickflowとの連携に使えるコネクタを備えたiPaaSも選択肢の一つです。[Workatoのkickflowコネクタ](https://docs.workato.com/en/connectors/kickflow)はPersonal Access TokenとService Account Tokenの両方の認証に対応し、レコードの作成・取得・更新・削除・検索とチケット操作ができます。[Yoomのヘルプ](https://intercom.help/yoom/ja/articles/10506879-kickflow%E3%81%A8%E9%80%A3%E6%90%BA%E3%81%99%E3%82%8B%E3%81%A8%E3%81%A7%E3%81%8D%E3%82%8B%E3%81%93%E3%81%A8)では、kickflowのWebhookをフローの起動条件にする使い方が説明されています。

「承認されたらSlackに通知する」「完了したらスプレッドシートに1行足す」程度なら、iPaaSで十分です。開発者向けには[kickflowのMCPサーバー](https://developer.kickflow.com/mcp/)も公開されており、Claude DesktopやCursorなどのAIアシスタントから自然言語でAPIを操作できます。iPaaSの仕組みと料金の数え方は[iPaaSの仕組みとRPAとの違い・料金の数え方](https://www.issoh.co.jp/column/details/13373/)を参照してください。

### 個別開発を選ぶ3つの条件と、kickflow自体の導入を見送る場面

個別開発を選ぶのは、次のどれかに当てはまる場合です。1つ目は、会計・基幹システム側に標準のコネクタがなく、仕訳や発注データへの変換ロジックが要る場合。2つ目は、月数千件の連携でiPaaSのタスク課金が膨らむ、またはREST APIの毎分30回の制限を考えた差分取得・再試行の設計が要る場合。3つ目は、重複配信や到達順の入れ替わりに対して、会計データの整合性を保証しなければならない場合です。連携方式の全体像（API・CSV・DB直結・iPaaS）は[ワークフローシステム連携の方式と設計](https://www.issoh.co.jp/column/details/18046/)で比較しています。

kickflow自体を見送る判断の基準は、契約の最小単位、承認経路と組織改編、他システムへの連携予定です。従業員が50人未満で契約の最小単位に届かない会社、承認経路が1〜2段で組織改編もほとんどない会社、申請を他システムへ流す予定がない会社では、グループウェア付属の申請機能で足ります。そもそもワークフローを入れるべきかから検討するなら、[ワークフローの仕組みとシステム化の判断基準](https://www.issoh.co.jp/column/details/12893/)から読むと整理しやすくなります。

kickflowと会計・人事・基幹システムをつなぐ連携部分の設計と開発、Webhook受信基盤の構築は、一創の[API開発・システム連携](https://www.issoh.co.jp/service/system/api/)でご相談いただけます。

## kickflowの料金・API・Webhook連携についてのよくある質問

kickflowの導入検討と連携の実装で、よく確認される点をまとめました。

### kickflowの料金はいくらですか？

2026年11月時点で公開価格はありません。初期費用は0円、月額はスタンダードかエンタープライズかのプランと、利用するID数に応じた個別見積りです。契約は50IDからで、30日間の無料トライアルがあります。見積りの前に、ID数、月間の申請件数と連携件数、SSOや監査ログ1年保存の要否を整理しておくと、プランの判断が早く済みます。

### kickflowのAPIは追加料金なしで使えますか？

REST APIとWebhookは公式の開発者ドキュメントで公開されており、Personal Access Tokenで呼び出せます。標準の利用制限はIPアドレスごとに毎分30回で、これを毎分300回まで広げる「REST API利用枠オプション」は有償です。プランごとの機能の範囲は変わることがあるため、使いたい連携が契約予定のプランで動くかを、トライアル中に実際に呼んで確かめてください。

### kickflowのWebhookが届かなくなったときは何を確認すればよいですか？

まず受信側が10秒以内に200を返しているかを確認します。300番台のリダイレクトも失敗扱いになるため、URL末尾のスラッシュ違いやHTTPからHTTPSへの転送に注意してください。1週間失敗し続けたWebhookは自動で無効化されるので、管理画面で設定が有効かも確かめます。署名の不一致で弾いている場合は、JSONを解析した後ではなく受信した生のバイト列で計算しているかを見直します。

### kickflowの承認経路は組織変更のたびに作り直す必要がありますか？

経路の承認者を個人名ではなく役職やチームで指定していれば、作り直しは要りません。kickflowは組織図を複数持てるため、翌期の組織図を事前に作っておき、切り替え日に有効化する運用ができます。APIにも組織図を有効化するエンドポイントがあり、人事システムの組織データから登録して切り替えを自動化することもできます。

### kickflowとほかのワークフローシステムはどう比べればよいですか？

比べる軸は、課金の単位と最小契約数、承認経路の柔軟さ、API・Webhookの公開範囲、SSOや監査ログなどの統制機能の4つです。kickflowは50IDからの見積り制で、APIの仕様書（OpenAPI定義）と変更履歴が公開されている点が連携を前提にする企業に向きます。製品タイプ別の比べ方は関連記事のワークフローシステム比較で解説しています。

## 関連記事

- [ワークフローシステム比較の判断軸4つ｜タイプ別の選び分けと費用の見方](https://www.issoh.co.jp/column/details/17504/)：kickflowを他製品と比べるときの軸
- [ワークフローシステムとは？機能・クラウドとオンプレの違い・選び方と自社開発の判断基準](https://www.issoh.co.jp/column/details/15254/)：製品カテゴリ全体の選び方
- [ワークフローシステム連携の方式と設計：API・CSV・DB直結・iPaaSの選び分け](https://www.issoh.co.jp/column/details/18046/)：連携方式の比較
- [Webhookの作り方と実装方法｜受信側の署名検証・冪等性と送信側の再送をNode.jsで解説](https://www.issoh.co.jp/tech/details/1378/)：受信側の実装の詳細
- [API連携ツールの選び方｜iPaaS・データ連携基盤・受託開発の使い分けを解説](https://www.issoh.co.jp/column/details/16376/)：連携手段の選び分け

---

出典: [kickflowとは？料金の決まり方とREST API・Webhookで他システムと連携する実装手順](<https://www.issoh.co.jp/tech/details/20106/>)（株式会社一創）
