Get a single actor

curl --request GET \
  --url https://api.hubapi.com/conversations/v3/conversations/actors/{actorId} \
  --header 'Authorization: Bearer <token>'

{
  "type": "AGENT",
  "id": "<string>",
  "name": "<string>",
  "email": "<string>",
  "avatar": "<string>"
}

GET

conversations

actors

{actorId}

Get a single actor

curl --request GET \
  --url https://api.hubapi.com/conversations/v3/conversations/actors/{actorId} \
  --header 'Authorization: Bearer <token>'

{
  "type": "AGENT",
  "id": "<string>",
  "name": "<string>",
  "email": "<string>",
  "avatar": "<string>"
}

Supported products

Requires one of the following products or higher.

Marketing Hub -Free

Sales Hub -Free

Service Hub -Free

Content Hub -Free

Data Hub -Free

Required Scopes

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

actorId

string

required

The unique ID of the actor.

property

string

A specific property to include in the actor response.

successful operation

type

enum<string>

default:AGENT

required

Available options:

AGENT

string

required

name

string

avatar

string

Last modified on December 16, 2025

⌘I