> ## Documentation Index
> Fetch the complete documentation index at: https://br.developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API do CRM | Proprietários

> **[Run in Postman](https://app.getpostman.com/run-collection/78f10c037170a05f3b3a)**

> **Requisitos de escopo**

# Proprietários

Os proprietários do HubSpot [atribuem](https://knowledge.hubspot.com/records/how-to-set-a-record-owner) 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](https://knowledge.hubspot.com/salesforce/install-the-hubspot-salesforce-integration).

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](https://br.developers.hubspot.com/docs/api-reference/settings-user-provisioning-v3/guide.md), mas resultará em um erro se for usado para atribuir propriedade.

Sua resposta será semelhante ao seguinte:

```json theme={null}
///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
    }
  ]
}
```

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:

```json theme={null}
///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
    }
  ]
}
```

## 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.

> [!WARNING]
>
> **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`.