HUhubspot
Actors

Retrieve actor

Changed on

Retrieve information about a specific actor in the conversations system using their unique actor ID. This endpoint is useful for obtaining details about a particular actor, which could be an agent, bot, or other entity involved in conversations.

get/conversations/conversations/2026-09/actors/{actorId}

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/conversations/conversations/2026-09/actors/{actorId}
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: conversations.read

Path parameters

actorIdstring required

The unique identifier of the actor to retrieve.

Query parameters

propertystring

A string representing a specific property of the actor to include in the response.

Response

successful operation

OR
OR
OR
OR
OR
OR

Changes