Webhook の追加 は /linkedin/webhooks/endpoints に対する POST で、MakeHybrid API の webhooks ファミリーに属します。すべてのリクエストは X-API-KEY ヘッダーに自分のキーを載せます。キーがどの組織であるかを決め、したがってどの LinkedIn アカウントを指定できるかも決めます。
Webhook は、知らされることと尋ね続けることの違いです。配信ごとに署名を検証し、同じイベントの再送はふつうのこととして扱ってください。
リクエスト
curl -X POST "https://makehybrid.com/linkedin/webhooks/endpoints" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
うまくいかないときに返るもの
- 401 — キーがない、誤っている、または失効している。
- 402 — プランが未払い。試用期間が終わると MakeHybrid API はこれを返します。
- 404 — 対象が存在しないか、そのアカウント id が自分のものではないか。id を探られないよう、両者は意図的に同じ答えにしています。
- 429 — リクエストが多すぎるか、LinkedIn がそのアカウントを抑えています。待つ以外に手はなく、早く再試行するほど長引きます。
- 503 — LinkedIn、またはその手前のホップが応答しませんでした。本文には見えたままの素のステータスが入ります。
エラーはすべて同じ形の JSON です: {"type":"errors/<code>","status":<n>,"detail":"..."} — ハンドラ 1 つで全部を受けられますし、detail は人に見せるために書かれています。
代わりにアシスタントに頼む
この操作は MCP ツールでもあります。https://makehybrid.com/linkedin/mcp/<自分の API キー> を Claude や ChatGPT、あるいは MCP を話すアシスタントに貼り付けて、ふつうの言葉で頼んでください。アシスタントが呼び出しを選び、id を埋め、答えを読み上げます。インストールするものはありません。
プロジェクトルームの中で
プロジェクトルームで、自分の AI エージェントの「使えるサーバー」の MakeHybrid にチェックを入れると、会話で必要になるたびに、そのエージェントが「Webhook の追加」をツールとして呼び出します。対象は、組織が接続した LinkedIn アカウントです。ルームの全員に、何を頼み、何が返ってきたかが見えます。ふつうの言葉で頼んでください。ここではエージェントの名前が @scout です：
- @scout どんな Webhook がある？ 直近の配信は成功した？
よくある質問
AI エージェントに「Webhook の追加」を呼び出してもらえますか？
はい。MCP を話すアシスタントなら、上のアドレスを通じて呼び出せますし、MakeHybrid にチェックを入れたプロジェクトルームの自分の AI エージェントも呼び出せます。ルームの組み込みエージェントにはできません。助言をするだけで、あなたの LinkedIn のキーを持っていないからです。
ルームの外、自分のコードからでも使えますか？
はい。上のリクエストは、AI エージェントのツールが呼ぶのと同じ操作で、答えもエラーも同じです。どの経路から入っても、どの LinkedIn アカウントを指定できるかはキーが決めます。
自分のブランドのルームでも使えますか？
はい。ホワイトラベルのアドレスでは、ツールが自社のプロダクト名で表示され、同じルールのもとで同じアカウントに届きます。
AI エージェントがこれを行う前に、人が承認できますか？
AI エージェントの指示に書いてください。これから行うことを伝え、ルームの誰かが「進めて」と言うまで待つように、と。ルームではすべての返答が全員に見えるので、LinkedIn で何かが変わる前に、そのリクエストが人の目に触れます。
どのプランか
MakeHybrid API、/linkedin 上。接続した LinkedIn アカウント 1 つにつき月 9 ドル、10 アカウントからは 7 ドル、1000 からは 5 ドル。1 アカウント分の 30 日間試用つき。