> ## 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. # CRM API | 会社レコード export const postmanIcon = ; export const ScopesList = ({scopes = [], description = "この API には、次のいずれかのスコープが必要です。"}) => { if (!scopes || scopes.length === 0) { return null; } const sortedScopes = scopes.sort((a, b) => a.localeCompare(b)); return

{description}

{sortedScopes.map((scope, index) =>


              {scope}

)}

; };

# 会社レコード

HubSpotの会社レコードには、自社とやり取りする組織に関する情報が保存されます。会社エンドポイントを使用することにより、会社レコードを作成および管理したり、HubSpotと他のシステムの間で会社データを同期したりできます。オブジェクト、レコード、プロパティー、および関連付けAPIの詳細については、[CRMについて](/guides/crm/understanding-the-crm)のガイドをご確認ください。HubSpotのオブジェクトとレコードに関する一般的な情報については、[CRMデータベースを管理する方法](https://knowledge.hubspot.com/ja/get-started/manage-your-crm-database)をご確認ください。 ## 会社レコードを作成する新しい会社レコードを作成するには、`POST`リクエストを`/crm/v3/objects/companies`に送信します。リクエスト内のpropertiesオブジェクトに会社データを含めます。また、associationsオブジェクトを追加して、新しい会社レコードを既存のレコード（コンタクト、取引など）やアクティビティー（ミーティング、メモなど）に関連付けることもできます。 ### プロパティー会社の詳細は、会社プロパティーに保存されます。[HubSpotのデフォルトの会社プロパティー](https://knowledge.hubspot.com/ja/properties/hubspot-crm-default-company-properties)がありますが、[カスタムプロパティーを作成](https://knowledge.hubspot.com/ja/contacts/manage-your-properties)することもできます。新しい会社レコードを作成する際は、`name`または`domain`プロパティーのうち、少なくとも1つをリクエストに含める必要があります。ドメイン名は会社レコードを[一意に識別する主要なID](https://knowledge.hubspot.com/ja/records/deduplication-of-records#automatic-deduplication-in-hubspot)であるため、HubSpotで会社が重複しないようにするために、常に`domain`を含めることを推奨します。会社レコードに[複数のドメイン](https://knowledge.hubspot.com/ja/records/add-multiple-domain-names-to-a-company-record)が含まれている場合は、`hs_additional_domains`フィールドに各ドメインをセミコロンで区切って指定することにより、API経由でドメインを追加できます。例：`"hs_additional_domains" : "domain.com; domain2.com; domain3.com"` 利用可能な全てのプロパティーを確認するには`GET`リクエストを`/crm/v3/properties/companies`に送信して、アカウントの会社プロパティーのリストを取得します。詳しくは[プロパティーAPI](/api-reference/crm-properties-v3/guide)をご参照ください。 **注**: リクエストに`lifecyclestage`を含める場合、値はライフサイクルステージの内部名を参照する必要があります。デフォルトのステージの内部名はテキスト値であり、ステージの[ラベル](https://knowledge.hubspot.com/ja/properties/create-and-edit-properties)（`subscriber`や`marketingqualifiedlead`など）を編集しても変更されません。[カスタムステージ](https://knowledge.hubspot.com/ja/object-settings/create-and-customize-lifecycle-stages)の内部名は数値です。ステージの内部IDを見つけるには、[ライフサイクルステージ設定](https://knowledge.hubspot.com/ja/object-settings/create-and-customize-lifecycle-stages)を確認するか、APIを使ってライフサイクルステージプロパティーを取得します。例えば、新しい会社レコードを作成する場合、リクエストの内容は次のようになります。 ```json theme={null} ///Example request body { "properties": { "name": "HubSpot", "domain": "hubspot.com", "city": "Cambridge", "industry": "Technology", "phone": "555-555-555", "state": "Massachusetts", "lifecyclestage": "51439524" } } ``` ### 関連付け新しい会社レコードを作成する際に、その会社レコードをassociationsオブジェクトの[既存のレコード](https://knowledge.hubspot.com/ja/records/associate-records)や[アクティビティー](https://knowledge.hubspot.com/ja/records/associate-activities-with-records)に関連付けることもできます。例えば、新しい会社レコードに既存のコンタクトとEメールアドレスを関連付ける場合、リクエストの内容は次のようになります。 ```json theme={null} ///Example request body { "properties": { "name": "HubSpot", "domain": "hubspot.com", "city": "Cambridge", "industry": "Technology", "phone": "555-555-555", "state": "Massachusetts", "lifecyclestage": "51439524" }, "associations": [ { "to": { "id": 101 }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 280 } ] }, { "to": { "id": 556677 }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 185 } ] } ] } ``` 次のものをassociationsオブジェクトに含める必要があります。 | パラメーター | 説明 | | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `to` | 会社レコードを関連付けるレコードまたはアクティビティー。一意の`id`値で指定します。 | | `types` | 会社とレコード／アクティビティーの間の関連付けのタイプ。`associationCategory`および`associationTypeId`を含めます。デフォルトの関連付けタイプIDは、[このページ](/api-reference/crm-associations-v4/guide#association-type-id-values)で確認できます。または、[関連付けAPI](/api-reference/crm-associations-v4/guide#retrieve-association-types)を使用して、カスタム関連付けタイプ（ラベル）の値を取得することもできます。 | ## 会社レコードを取得する会社レコードを個別に、または一括で取得できます。 * 個々の会社レコードを取得するには、`GET`リクエストを`/crm/v3/objects/companies/{companyId}`に送信します。 * 全ての会社レコードのリストを要求するには、`GET`リクエストを`/crm/v3/objects/companies`に送信します。これらのエンドポイントに対し、リクエストのURLに次のクエリーパラメーターを含めることができます。 | パラメーター | 説明 | | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | `properties` | レスポンスで返されるプロパティーのカンマ区切りリスト。リクエスト対象の会社レコードで、指定したプロパティーに値が設定されていない場合、そのプロパティーはレスポンスに含まれません。 | | `propertiesWithHistory` | レスポンスで返される現在および過去のプロパティーのカンマ区切りリスト。リクエスト対象の会社レコードで、指定したプロパティーに値が設定されていない場合、そのプロパティーはレスポンスに含まれません。 | | `associations` | 関連付けられているIDが取得されるオブジェクトのカンマ区切りリスト。存在しない関連付けを指定した場合、その関連付けはレスポンスで返されません。詳しくは[関連付けAPI](/api-reference/crm-associations-v4/guide)をご参照ください。 | * レコードIDまたは[カスタムの固有IDプロパティー](/api-reference/crm-properties-v3/guide#create-unique-identifier-properties)を指定して、特定の会社レコードを一括で取得するには、`POST`リクエストを`crm/v3/objects/companies/batch/read`に送信します。このバッチエンドポイントは関連付けを取得できません。[関連付けAPI](/api-reference/crm-associations-v4/guide)を使用して関連付けを一括で読み取る方法について説明します。一括読み取りエンドポイントの場合は、任意指定の`idProperty`パラメーターを使用し、カスタムの[固有IDプロパティー](/api-reference/crm-properties-v3/guide#create-unique-identifier-properties)を指定して、会社レコードを取得することもできます。デフォルトで、リクエストの`id`値はレコードID（`hs_object_id`）を参照するため、レコードIDを使って取得するときには`idProperty`パラメーターは不要です。カスタムの固有の値のプロパティーを使用して会社レコードを取得するには、`idProperty`パラメーターを含める必要があります。例えば、会社レコードを一括で取得する場合のリクエストは、次のいずれかのようになります。 ```json theme={null} ///Example request body with record ID { "properties": ["name", "domain"], "inputs": [ { "id": "56789" }, { "id": "23456" } ] } ``` ```json theme={null} ///Example request body with a unique value property { "properties": ["name", "domain"], "idProperty": "uniquepropertyexample", "inputs": [ { "id": "abc" }, { "id": "def" } ] } ``` プロパティーの現在の値と過去の値を含む会社を取得する場合のリクエストは、次のようになります。 ```json theme={null} ///Example request body with record ID (current and historical values) { "propertiesWithHistory": ["name"], "inputs": [ { "id": "56789" }, { "id": "23456" } ] } ``` ## 会社レコードを更新する会社レコードを個別に、または一括で更新できます。既存の会社の場合、APIを介して会社レコードを更新するために使用可能な固有の値は、会社のレコードIDです。会社IDを基に会社レコードを個別に更新するには、`PATCH`リクエストに更新対象のデータを含めて`/crm/v3/objects/companies/{companyId}`に送信します。 \*\*注 \*\*：`lifecyclestage`プロパティーを更新する場合、ライフサイクルステージの先のステージにのみ値を設定できます。ライフサイクルステージの前のステージに設定するには、まずレコードの既存のライフサイクルステージの値をクリアする必要があります。この値は[手動でクリア](https://knowledge.hubspot.com/ja/records/update-a-property-value-for-a-record)できます。または、[ワークフロー](https://knowledge.hubspot.com/ja/records/change-record-lifecycle-stages-in-bulk)やコンタクトデータを同期する連携機能によってこの値を自動的にクリアすることもできます。 ### 既存の会社レコードを他のレコードまたはアクティビティーに関連付ける会社レコードを他のCRMレコードまたはアクティビティーに関連付けるには、`PUT`リクエストを`/crm/v3/objects/companies/{companyId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}`に送信します。 `associationTypeId`値を取得するには、デフォルト値の[このリスト](/api-reference/crm-associations-v4/guide#association-type-id-values)を参照するか、`GET`リクエストを`/crm/v4/associations/{fromObjectType}/{toObjectType}/labels`に送信します。レコード関連付けの詳細については[関連付けAPI](/api-reference/crm-associations-v4/guide)をご確認ください。 ### 関連付けを削除する会社レコードと他のレコードまたはアクティビティーの関連付けを削除するには、`DELETE`リクエストを`/crm/v3/objects/companies/{companyId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}`に送信します。 ## 会社レコードでアクティビティーをピン留めするリクエストに`hs_pinned_engagement_id`フィールドを含めることで、APIを介して会社レコードでアクティビティーをピン留めできます。フィールドに、ピン留めするアクティビティーの`id`を含めます。これは[エンゲージメントAPI](/api-reference/overview)を介して取得できます。レコードごとに1つのアクティビティーをピン留めすることができ、そのアクティビティーはピン留めする前にすでに会社レコードに関連付けられている必要があります。会社にピン留めするアクティビティーを設定または更新する場合、リクエストは次のようになります。 ```json theme={null} ///Example request body PATCH /crm/v3/objects/companies/{companyId} { "properties": { "hs_pinned_engagement_id": 123456789 } } ``` 同じリクエスト内で、会社を作成し、既存のアクティビティーに関連付け、アクティビティーをピン留めすることもできます。以下に例を示します。 ```json theme={null} ///Example request body POST /crm/v3/objects/companies { "properties": { "domain": "example.com", "name": "Example Company", "hs_pinned_engagement_id": 123456789 }, "associations": [ { "to": { "id": 123456789 }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 189 } ] } ] } ``` ## 会社レコードを削除する会社レコードを個別に、または一括で削除できます。削除した会社レコードは、HubSpot内のごみ箱に追加されます。そのため、必要に応じて後で[HubSpot内で会社レコードを復元](https://knowledge.hubspot.com/ja/records/restore-deleted-records)できます。 IDを基準に会社レコードを個別に削除するには、`DELETE`リクエストを`/crm/v3/objects/companies/{companyId}`に送信します。会社を一括で削除する方法について詳しくは、 [リファレンスドキュメント](/api-reference/crm-companies-v3/guide)をご確認ください。