Basic

Retrieve a specific owner by ID

Changed on

Retrieve details of a specific owner using either their 'id' or 'userId'.

get/crm/owners/2026-09/{ownerId}

Request

  • Base URL
    https://api.hubapi.com
  • Auth
    • OAuth 2
      Authorization codehttps://app.hubspot.com/oauth/authorize
      Token URLhttps://api.hubapi.com/oauth/v1/token
      Scopesautomation
    • or OAuth 2
      Authorization codehttps://app.hubspot.com/oauth/authorize
      Token URLhttps://api.hubapi.com/oauth/v1/token
      Scopescrm.objects.owners.read
    • or OAuth 2
      Authorization codehttps://app.hubspot.com/oauth/authorize
      Token URLhttps://api.hubapi.com/oauth/v1/token
      Scopescrm.pipelines.approval.read
    • or OAuth 2
      Authorization codehttps://app.hubspot.com/oauth/authorize
      Token URLhttps://api.hubapi.com/oauth/v1/token
      Scopescrm.pipelines.governance.write

Path parameters

ownerIdinteger required

The unique identifier of the owner to retrieve.

Query parameters

archivedboolean

Whether to return only results that have been archived.

idProperty'id' | 'userId'

Specifies which property to use for identifying the owner. Valid values are 'id' or 'userId'. Defaults to 'id'.

Response

successful operation

archivedboolean required

Indicates whether the owner is archived.

createdAtstring date-time required

The date and time when the owner was created.

emailstring

The email address of the owner.

firstNamestring

The first name of the owner.

idstring required

The unique identifier of the owner.

lastNamestring

The last name of the owner.

type'PERSON' | 'QUEUE' required

The type of the owner, which can be either PERSON or QUEUE.

updatedAtstring date-time required

The date and time when the owner was last updated.

userIdinteger

The user ID of the owner.

userIdIncludingInactiveinteger

The user ID of the owner, including inactive users.

Changes

  • 2026-09329a9dbd3836Revision changes
    • info

      the security scope automation was added to the endpoint's security scheme oauth2

    • info

      the security scope crm.pipelines.governance.write was removed from the endpoint's security scheme oauth2

  • 2026-098d7218c5d05bRevision changes
    • info

      the security scope automation was added to the endpoint's security scheme oauth2

    • info

      the security scope crm.objects.owners.read was removed from the endpoint's security scheme oauth2