Zum Hauptinhalt springen
Dernière modification : 22 août 2025

Run in Postman

 Les propriétaires HubSpot attribuent des utilisateurs spécifiques à des fiches d’informations, des activités ou des tâches marketing, et peuvent être utilisés dans des jetons de personnalisation pour votre contenu. Les propriétaires sont automatiquement créés et mis à jour dans HubSpot lorsque de nouveaux utilisateurs sont ajoutés ou que les propriétaires existants sont synchronisés depuis Salesforce. Les points de terminaison de l’API des propriétaires sont en lecture seule. Vous pouvez donc les utiliser pour récupérer les informations d’identification d’un propriétaire, y compris l’ID du propriétaire. Cet identifiant peut ensuite être utilisé pour attribuer la propriété à des fiches d’informations de CRM dans HubSpot, via une intégration ou des appels d’API de modification de propriété.

​
Récupérer une liste de propriétaires

Pour récupérer les propriétaires actuels de votre compte, effectuez une demande GET à /crm/v3/owners. La réponse renverra le nom de chaque utilisateur, son adresse e-mail, les valeurs de son identifiant, les dates de création/mise à jour et, le cas échéant, les informations de l’équipe. Deux valeurs d’ID sont renvoyées, qui sont utilisées à des fins différentes :
  • id : l’ID du propriétaire. Cette valeur doit être utilisée lors de la récupération d’informations sur un propriétaire spécifique et lors de l’attribution d’un propriétaire à une fiche d’informations ou à une activité.
  • userId : l’ID de l’utilisateur. Cette valeur peut être utilisée pour spécifier des utilisateurs dans l’API des paramètres, mais entraînera une erreur si elle est utilisée pour attribuer la propriété.
Votre réponse ressemblera à ce qui suit : 
///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
    }
  ]
}
Vous pouvez également récupérer des propriétaires archivés pour afficher les utilisateurs qui ont été désactivés. Pour ce faire, ajoutez le paramètre archived avec la valeur true. Pour les utilisateurs archivés, il y a toujours une valeur id, mais la valeur userId sera null. Au lieu de cela, l’ID utilisateur est stocké dans le champ userIdIncludingInactive. Par exemple : 
///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
    }
  ]
}

​
Récupérer des informations sur un propriétaire individuel

Pour récupérer un propriétaire spécifique, effectuez une demande GET à /crm/v3/owners/{ownerId}. Vous devez utiliser la valeur id pour spécifier le propriétaire pour lequel vous souhaitez obtenir plus de détails.

​
Remarque:

La valeur updatedAt de la réponse change en fonction des mises à jour apportées à l’objet Propriétaire lui-même. Elle ne sera pas mise à jour pour des modifications apportées à l’objet d’utilisateur. Par exemple, la modification des autorisations d’un utilisateur ne mettra pas à jour la valeur updatedAt.
⌘I