HubSpot API は、CRM プラットフォーム HubSpot のデータと自動化を外部システムから操作するためのものだ。コンタクト・企業・取引といった営業データの「正」を HubSpot に置き、周辺システムと同期させる構成で力を発揮する。

統合のハブとして使う

実務でよくあるのは、自社プロダクトのサインアップやイベントを HubSpot のコンタクトに反映し、マーケティング側のワークフロー（メール配信やスコアリング）のトリガーにする使い方だ。リード獲得からナーチャリングまでを 1 本のパイプラインにできる。カスタムオブジェクトを定義できるため、標準の 3 オブジェクトに収まらない業種固有のデータも CRM 側で扱える。

料金の落とし穴

CRM の基本 API（コンタクト・企業・取引の CRUD）は無料で使える。ここが誤解されやすい点で、「API は無料」と「機能は無料」は別物だ。マーケティングメール送信やワークフロー自動化など、Marketing Hub / Sales Hub の有料機能に対応する API を叩くには、それぞれのプラン契約が前提になる。API ドキュメントにエンドポイントが載っていても、プラン未契約だと権限エラーになる。

加えて、マーケティングコンタクト数で課金階層が決まるプランでは、API で大量のコンタクトを流し込むとそのまま課金区分が上がる。「同期したら請求が跳ねた」を避けるため、どのコンタクトをマーケティング対象にカウントするかの設計を先に決めておきたい。

レート制限と向かないケース

API には日次・秒間のレート制限があり、初回の大量データ移行ではここに当たりやすい。一括処理はバッチ API を使い、リトライ設計を入れておく。

なお CRM を使わず、純粋にメールを大量配信したいだけなら HubSpot は重い。その用途は SendGrid のような配信特化サービスの方が単価も運用も合う。HubSpot が効くのは、あくまで顧客データの管理と自動化が中心にあるときだ。