最終更新日: 2025年8月22日

Run in Postman

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値は更新されません