GTM Context

Create Persona

Create a Studio buyer persona (manual - no AI generation).

Read-side counterpart already exists (GET /personas); this closes the "read but can't create" gap for the Persona bucket. The new persona is created with status 'active' and returned in the same shape as GET /personas.

post/personas

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/personas
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

titlestring required

Persona title (e.g. 'Director of Marketing Operations').

website_urlstring required

The org website this persona belongs to.

priorityinteger nullable

Display priority (lower sorts first). Defaults to 1.

confidencestring nullable

Confidence label (e.g. 'high'/'medium'/'low'). Defaults to 'medium'.

why_targetstring nullable

Why this persona is worth targeting.

expected_receptivitystring nullable

Expected receptivity note.

campaign_approachstring nullable

Recommended campaign approach.

recommended_goalstring nullable

Recommended campaign goal.

sourcestring nullable

Origin label for the persona. Defaults to 'manual'.

Response

Successful Response

dataobject required

Changes

No recorded changes to this operation across all 2 revisions of this API.