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 が効くのは、あくまで顧客データの管理と自動化が中心にあるときだ。
関連付けの構造を理解しないと使えない
HubSpot のデータは、コンタクト・会社・取引・チケットといったオブジェクトが相互に関連付けられた構造になっている。単純に「コンタクトを作る」だけなら簡単だが、実務では「この取引はこの会社のこの担当者に紐づく」という関連まで正しく設定する必要がある。関連付けを省いて登録すると、営業側の画面では情報が分断されて見え、結局手作業での紐づけが発生する。
外部システムから流し込むとき、既存のコンタクトを検索せずに作成すると重複が積み上がります。メールアドレスを一意キーとして先に検索し、あれば更新・なければ作成する処理（upsert 相当）を必ず入れてください。重複が増えてからの統合作業は非常に手間がかかります。
カスタムプロパティの設計
標準のプロパティで足りない情報はカスタムプロパティとして追加できるが、内部名は後から変えにくく、削除するとデータも失われる。連携を作る前に、どの情報をどのオブジェクトのどのプロパティに置くかを設計しておきたい。とくに複数システムから同じプロパティを更新する構成では、どちらの値が正なのかを決めておかないと、上書き合戦が起きる。