会社
HubSpotの会社レコードには、自社とやり取りする組織に関する情報が保存されます。会社エンドポイントを使用することにより、会社レコードを作成および管理したり、HubSpotと他のシステムの間で会社データを同期したりできます。
オブジェクト、レコード、プロパティー、および関連付けAPIの詳細については、「CRMについて」のガイドをご確認ください。HubSpotのオブジェクトとレコードに関する一般的な情報については、CRMデータベースを管理する方法をご確認ください。
新しい会社レコードを作成するには、POST
リクエストを/crm/v3/objects/companies
に送信します。
リクエスト内のpropertiesオブジェクトに会社データを含めます。また、associationsオブジェクトを追加して、新しい会社レコードを既存のレコード(コンタクト、会社など)やアクティビティー(ミーティング、メモなど)に関連付けることもできます。
会社の詳細は、会社プロパティーに保存されます。HubSpotの既定の会社プロパティーがありますが、カスタムプロパティーを作成することもできます。
新しい会社レコードを作成する際は、name
またはdomain
プロパティーのうち、少なくとも1つをリクエストに含める必要があります。ドメイン名は会社を一意に識別する主要なIDであるため、HubSpotで会社レコードが重複しないようにするために、常にdomain
を含めることを推奨します。会社が複数のドメインを所有している場合は、hs_additional_domains
フィールドに各ドメインをセミコロンで区切って指定することにより、API経由でドメインを追加できます。例:"hs_additional_domains" : "domain.com; domain2.com; domain3.com"
利用可能な全てのプロパティーを確認するには、GET
リクエストを/crm/v3/properties/companies
に送信して、アカウントの会社プロパティーのリストを取得します。詳しくはプロパティーAPIをご確認ください。
lifecyclestage
in your request, values must refer to the lifecycle stage's internal name. The internal names of default stages are text values, and do not change even if you edit the stage's label(e.g., subscriber
or marketingqualifiedlead
). The internal names of custom stages are numeric values. You can find a stage's internal ID in your lifecycle stage settings, or by retrieving the lifecycle stage property via API.
例えば、新しい会社レコードを作成する場合、リクエストの内容は次のようになります。
Parameter | Description |
---|---|
toObjectId
| 会社を関連付けるレコードまたはアクティビティーのID。 |
associationTypeId
| 会社と他のオブジェクトまたはアクティビティーとの関連付けタイプを示す一意の識別子。値を取得するには、 |
label
フィールドを含めて、関連付けを説明する定義済み関連付けラベルを割り当てることもできます。関連付けAPIを使用してレコードを関連付ける方法について詳細をご確認ください。
例えば、新しい会社レコードに既存のコンタクトとEメールアドレスを関連付ける場合、リクエストの内容は次のようになります。
会社レコードを個別に、または一括で取得できます。個々の会社レコードを取得するには、GET
リクエストを/crm/v3/objects/companies/{companyId}
に送信します。
全ての会社レコードのリストを取得するには、GET
リクエストを/crm/v3/objects/companies
に送信します。
どちらのエンドポイントに対しても、リクエストのURLに次のクエリーパラメーターを含めることができます。
Parameter | Description |
---|---|
properties
| レスポンスで取得するプロパティーのカンマ区切りリスト。リクエスト対象の会社レコードで、指定したプロパティーに値が設定されていない場合、そのプロパティーはレスポンスに含まれません。 |
associations
| 関連付けられているIDが取得されるオブジェクトの、カンマ区切りリスト。存在しない関連付けを指定した場合、その関連付けはレスポンスで返されません。詳しくは関連付けAPIをご確認ください。 |
会社レコードを取得する方法について詳しくは、この記事の上部にある[エンドポイント]タブをクリックしてください。
会社レコードを他のCRMレコードまたはアクティビティーに関連付けるには、PUT
リクエストを/crm/v3/objects/companies/{companyId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}
に送信します。
associationTypeId
value, make a GET
request to /crm/v4/associations/{fromObjectType}/{toObjectType}/labels
.
レコードを関連付ける方法について詳しくは関連付けAPIご確認ください。
会社レコードと他のレコードまたはアクティビティーの関連付けを削除するには、DELETE
リクエストを/crm/v3/objects/companies/{companyId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}
に送信します。
会社レコードを個別に、または一括で削除できます。削除した会社レコードは、HubSpot内のごみ箱に追加されます。そのため、必要に応じて後でHubSpot内で会社レコードを復元できます。
IDを基準に個々の会社レコードを削除するには、DELETE
リクエストを/crm/v3/objects/companies/{companyId}
に送信します。
会社レコードを一括で削除する方法については、この記事の上部にある[エンドポイント]タブをクリックしてください。
貴重なご意見をありがとうございました。