最終更新日: 2025年8月22日
HubSpot所有者は特定のユーザーをレコード、アクティビティー、またはマーケティングタスクに割り当てます。所有者をコンテンツのパーソナライズトークンに使用できます。新しいユーザーが追加されたとき、または既存の所有者がSalesforceから同期されたときに、所有者がHubSpotで自動的に作成および更新されます。
所有者APIエンドポイントは読み取り専用ですから、これらを使用して所有者識別情報(所有者IDなど)を取得できます。その後、この識別情報を使用し、連携またはプロパティー変更API呼び出しを介して、所有権をHubSpotのCRMレコードに割り当てることができます。
所有者のリストを取得する
アカウントの現在の所有者を取得するには、GET
リクエストを/crm/v3/owners
に送信します。レスポンスでは、各ユーザーの名前、Eメール、ID値、作成/更新日付、および該当する場合はチーム情報が返されます。返される次の2つのID値は、それぞれ異なる目的で使用されます。
id
:所有者のID。この値は、特定の所有者に関する情報を取得するとき、および所有者をレコードまたはアクティビティーに割り当てるときに使用されます。
userId
:ユーザーのID。この値を使用して設定APIでユーザーを指定できます。ただし所有権の割り当てにこれを使用するとエラーが発生します。
レスポンスは次のようになります。
///Example response GET crm/v3/owners
{
"results": [
{
"id": "41629779",
"email": "email@hubspot.com",
"type": "PERSON",
"firstName": "HubSpot",
"lastName": "Test Owner",
"userId": 9586504,
"userIdIncludingInactive": 9586504,
"createdAt": "2019-12-25T13:01:35.228Z",
"updatedAt": "2023-08-22T13:40:26.790Z",
"archived": false,
"teams": [
{
"id": "368389",
"name": "Sales Team",
"primary": true
}
]
},
{
"id": "60158084",
"email": "email@gmail.com",
"type": "PERSON",
"firstName": "Test",
"lastName": "Email",
"userId": 9274996,
"userIdIncludingInactive": 9274996,
"createdAt": "2021-02-10T17:59:04.891Z",
"updatedAt": "2023-02-09T17:41:52.767Z",
"archived": false,
"teams": [
{
"id": "368389",
"name": "Sales Team",
"primary": true
}
]
},
{
"id": "81538190",
"email": "salesmanager@hubspot.com",
"type": "PERSON",
"firstName": "Sales",
"lastName": "Manager Example",
"userId": 3892666,
"userIdIncludingInactive": 3892666,
"createdAt": "2021-05-27T16:55:57.242Z",
"updatedAt": "2022-08-02T18:34:35.039Z",
"archived": false
}
]
}
アーカイブされた所有者のリストを取得して、非アクティブにされたユーザーを確認することもできます。それには、値をtrue
に設定したarchived
パラメーターを追加します。アーカイブされたユーザーにもid
値はありますが、userId
値はnull
になります。この場合、ユーザーIDはuserIdIncludingInactive
フィールドに格納されます。
例:
///Example response GET crm/v3/owners/?archived=true
{
"results": [
{
"id": "42103462",
"email": "useremail@hubspot.com",
"type": "PERSON",
"firstName": "",
"lastName": "",
"userId": null,
"userIdIncludingInactive": 9685555,
"createdAt": "2020-01-09T20:28:50.080Z",
"updatedAt": "2020-01-09T20:28:50.080Z",
"archived": true
}
]
}
個々の所有者に関する情報を取得する
特定の所有者の情報を取得するには、GET
リクエストを/crm/v3/owners/{ownerId}
に送信します。詳細を取得する対象の所有者を指定するには、id
値を使用する必要があります。
**注:**レスポンスに含まれるupdatedAt
値は、Ownerオブジェクト自体の更新に基づいて変更されます。Userオブジェクトに変更が加えられても更新されません。例えば、ユーザーの権限を変更してもupdatedAt
値は更新されません。