Pular para o conteúdo principal
Última modificação: 4 de dezembro de 2025

Run in Postman

 Os proprietários do HubSpot atribuem usuários específicos a registros, atividades ou tarefas de marketing e podem ser usados em tokens de personalização para o seu conteúdo. Os proprietários são criados e atualizados automaticamente no HubSpot quando novos usuários são adicionados ou quando os proprietários existentes são sincronizados a partir do Salesforce. Os pontos de extremidade de API dos proprietários são somente leitura. Você pode usá-los para recuperar os detalhes de identificação de um proprietário, incluindo o ID. Esse identificador pode ser usado para atribuir propriedade aos registros do CRM no HubSpot, por meio de uma integração ou por meio de chamadas de API de alteração de propriedade.

​
Recuperar uma lista de proprietários

Para recuperar os proprietários atuais em sua conta, faça uma solicitação GET para /crm/v3/owners. A resposta retornará o nome de cada usuário, e-mail, valores de ID, datas de criação/atualização e, se aplicável, informações da equipe. Dois valores de ID são retornados e eles são usados para fins diferentes:
  • id: o ID do proprietário. Esse valor deve ser usado ao recuperar informações sobre um proprietário específico e ao atribuir um proprietário a um registro ou atividade.
  • userId: o ID do usuário. Esse valor pode ser usado para especificar usuários na API de configurações, mas resultará em um erro se for usado para atribuir propriedade.
Sua resposta será semelhante ao seguinte: 
///Example response GET crm/v3/owners
{
  "results": [
    {
      "id": "41629779",
      "email": "[email protected]",
      "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 protected]",
      "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": "[email protected]",
      "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
    }
  ]
}
Você também pode recuperar proprietários arquivados para exibir usuários que foram desativados. Para fazer isso, adicione o parâmetro archived com o valor true. Para usuários arquivados, ainda há um valor id, mas o valor userId será null. O ID do usuário é armazenado no campo userIdIncludingInactive. Por exemplo: 
///Example response GET crm/v3/owners/?archived=true
{
  "results": [
    {
      "id": "42103462",
      "email": "[email protected]",
      "type": "PERSON",
      "firstName": "",
      "lastName": "",
      "userId": null,
      "userIdIncludingInactive": 9685555,
      "createdAt": "2020-01-09T20:28:50.080Z",
      "updatedAt": "2020-01-09T20:28:50.080Z",
      "archived": true
    }
  ]
}

​
Recuperar informações sobre um proprietário individual

Para recuperar um proprietário específico, faça uma solicitação GET para /crm/v3/owners/{ownerId}. Você deve usar o valor id para especificar o proprietário para o qual deseja obter mais informações.
Observação: o valor updatedAt na resposta é alterado com base nas atualizações do próprio objeto Proprietário. Ele não será atualizado para alterações no objetoUsuário. Por exemplo, alterar as permissões de um usuário não atualizará o valor updatedAt.