> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.jp/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# レガシーAPIリファレンス

> HubSpotのレガシー数値バージョニングAPI（v1〜v4）のリファレンスドキュメント。

<Warning>
  **ご注意ください：** このセクションのAPIはレガシーの数値バージョニング（v1、v2、v3、v4）を使用しており、将来のリリースで非推奨となる予定です。新しいインテグレーションには、代わりに[2026-03 API](/api-reference/latest/overview)を使用してください。日付ベースのバージョンパス（例：`/crm/objects/2026-03/contacts`）への移行により、HubSpotが日付ベースバージョニングに移行する中でインテグレーションの長期サポートが確保されます。
</Warning>

レガシーAPIリファレンスは、HubSpotの旧式の数値バージョニングエンドポイントを扱っています。これらのAPIはv4、v3、v2、v1の4つのメジャーバージョンレベルにまたがり、それぞれHubSpotプラットフォームの異なる世代を反映しています。エンドポイントは次のパターンに従います：

```text theme={null}
/api-name/v{version}/resource
```

例えば、v3 CRM Objects APIを使用してコンタクトを取得するには：

```bash theme={null}
GET /crm/v3/objects/contacts/{contactId}
```

## バージョン別API

### v4

v4エンドポイントは、日付ベースバージョニング以前の最新APIであり、アソシエーションとオートメーションアクションを扱います。

* **CRM Associations v4:** (`/crm/v4/associations/`、`/crm/v4/objects/{objectType}/{objectId}/associations/`) レコード間のアソシエーションの作成、読み取り、削除。アソシエーションラベルとタイプの設定
* **Automation Workflow Actions v4:** (`/automation/v4/actions/`) 入力フィールド、実行コールバック、アクション定義を持つカスタムワークフローアクションの定義

***

### v3

HubSpotのコアプラットフォームAPIのほとんどはv3です。CRM、CMS、オートメーション、マーケティングの主要なエンドポイントが含まれます。

* **CRM Objects v3:** (`/crm/v3/objects/{objectType}`) コンタクト、会社、取引、チケット、その他すべての標準およびカスタムCRMオブジェクトのCRUDおよびバッチ操作。検索、マージ、GDPR削除、スキーマ管理を含む
* **CRM Associations v3:** (`/crm/v3/associations/{fromObjectType}/{toObjectType}/batch/`) アソシエーションのバッチ読み取り、作成、削除
* **CRM Properties v3:** (`/crm/v3/properties/{objectType}`) オブジェクトプロパティとプロパティグループの作成と管理
* **CRM Pipelines v3:** (`/crm/v3/pipelines/{objectType}`) 取引とチケットのパイプラインとステージの管理
* **CRM Imports/Exports v3:** (`/crm/v3/imports/`、`/crm/v3/exports/`) CRMレコードの一括インポートとエクスポート
* **CRM Lists v3:** (`/crm/v3/lists/`) コンタクトと会社のリストの作成と管理
* **CRM Extensions v3:** (`/crm/v3/extensions/`) コーリング拡張とビデオ会議インテグレーション
* **Automation Workflows v3:** (`/automation/v3/workflows/`) HubSpotワークフローの作成、取得、削除
* **Conversations v3:** (`/conversations/v3/`) 受信トレイ、スレッド、メッセージ、カスタムチャネルの管理
* **CMS v3:** (`/cms/v3/`) ブログ記事、ページ、HubDB、ソースコード、ドメイン、URLマッピング、リダイレクト
* **Marketing Events v3:** (`/marketing/v3/marketing-events/`) マーケティングイベントレコードと出席の作成と管理
* **Communication Preferences v3:** (`/communication-preferences/v3/`) サブスクリプション定義とステータスの管理
* **Webhooks v3:** (`/webhooks/v3/`) Webhookサブスクリプションと設定の構成
* **Events v3:** (`/events/v3/`) カスタム行動イベントの送信と管理
* **Files v3:** (`/files/v3/`) ファイルとフォルダーのアップロード、管理、取得

***

### v2

v2 APIはCRMおよびCMSエンドポイントの旧バージョンであり、その多くにはv3の後継があります。

* **CRM Properties v2:** (`/properties/v2/{objectType}/properties`) コンタクト、会社、取引のプロパティとプロパティグループの管理
* **CRM Companies v2:** (`/companies/v2/companies/`) 会社レコードの作成、読み取り、更新、削除
* **CRM Deals v2:** （v1と重複。取引レベルのパスに一部のバッチ更新エンドポイントあり）
* **CMS Blog Posts v2:** (`/content/api/v2/blog-posts/`) ブログ記事の下書き、バージョン、公開の管理
* **CMS Pages v2:** (`/content/api/v2/pages/`) ウェブサイトおよびランディングページの管理
* **CMS Blog Settings v2:** (`/content/api/v2/blogs/`) ブログ設定の読み取り
* **CMS Site Search v2:** (`/site-search/v2/`) インデックスされたサイトコンテンツの検索とインデックスされたプロパティの取得
* **CMS Layouts and Templates v2:** (`/content/api/v2/`) CMSテンプレートとレイアウトの管理
* **Automation Workflows v2:** (`/automation/v2/workflows/`) コンタクトのワークフロー登録管理
* **Marketing Forms v2:** (`/forms/v2/forms/`) HubSpotフォームの作成、読み取り、更新、削除。フィールド定義の取得

***

### v1

v1 APIは最も古い世代であり、主にレガシーのコンタクト、取引、エンゲージメント、アカウントのエンドポイントです。

* **CRM Contacts v1:** (`/contacts/v1/`) コンタクトの作成、読み取り、更新、削除。セカンダリメールの管理。バッチ操作。検索
* **CRM Deals v1:** (`/deals/v1/deal/`) 取引レコードの作成、読み取り、更新、削除。非同期バッチ更新
* **CRM Line Items v1:** (`/crm-objects/v1/objects/line-items/`) 品目レコードとバッチ操作の管理
* **CRM Products v1:** (`/crm-objects/v1/objects/products/`) 製品レコードの管理
* **CRM Tickets v1:** (`/crm-objects/v1/objects/tickets/`) チケットレコードの管理
* **CRM Owners v2:** (`/owners/v2/owners/`) CRMオーナーの取得
* **CRM Pipelines v1:** (`/crm-pipelines/v1/pipelines/{objectType}`) パイプラインとステージの管理
* **CRM Lists v1:** (`/contacts/v1/lists/`) 静的および動的コンタクトリストの作成と管理
* **CRM Associations v1:** (`/crm-associations/v1/associations/`) オブジェクト間のアソシエーションの作成、読み取り、削除
* **CRM Engagements v1:** (`/engagements/v1/engagements/`) コール、メール、ミーティング、メモ、タスクをエンゲージメントレコードとして作成と管理
* **CRM Extensions v1:** (`/extensions/sales-objects/v1/`) CRMカードオブジェクトタイプの設定
* **Account Info v1:** (`/integrations/v1/me`) 認証されたアカウントの基本情報の取得
* **Communication Preferences v1:** (`/email/public/v1/subscriptions/`) メールサブスクリプションステータスの読み取りと更新
* **Marketing Forms v1:** (`/form-integrations/v1/`) フォーム送信と署名付きファイルURLの取得
* **Marketing Transactional Send v1:** (`/email/public/v1/singleEmail/send`) 単一のトランザクションメール送信。SMTP APIトークンの管理
* **CMS Domains v1:** (`/cms/v1/domains/`) CMSドメイン設定の一覧と取得
* **Reporting v2:** (`/analytics/v2/reports/`) コンテンツとイベントの分析データの取得