Skip to main content
GET
Get a person's communication profile
Returns the person’s current communication profile — preferred response name, signature, tone, examples, writing instructions and automation authorization — with its head and current revision, or head and revision both null before the first save. A revision never names its editor. Requires workforce:manage at the platform scope; a key or app whose grant covers only some org units receives 403. A person with any seat in a customer organization or an org unit under one returns 404, exactly as an unknown person, and so does an ID merged into such a person; a merged-away ID otherwise resolves to the person it was merged into.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Path Parameters

personId
string
required
Minimum string length: 1

Response

Success

data
object
required
meta
object
required