Skip to main content
POST
Create Persona

Authorizations

api_key
string
header
required

Body

application/json

Persona creation input

name
string
required

The external name of the persona

Minimum string length: 1
Example:

"VP of Sales"

internalName
string

The internal name of the persona

Example:

"Sally the Sales Leader"

description
string

A description of the persona

Example:

"Senior sales leaders responsible for revenue growth"

primaryResponsibilities
string[]

The primary responsibilities of the persona

Example:
painPoints
string[]

The pain points of the persona

Example:
keyConcerns
string[]

The key concerns of the persona

Example:
keyObjectives
string[]

The key objectives of the persona

Example:
commonJobTitles
string[]

The common job titles of the persona

Example:
whyTheyMatterToUs
string[]

The reasons why the persona matters to us

Example:
whyWeMatterToThem
string[]

The reasons why we matter to this type of persona

Example:
buyingRole
string[]

The function this persona typically plays in a purchase decision (e.g. economic buyer, champion, technical evaluator, end user, influencer, blocker), along with their level of sophistication on the problem space.

Example:
customFields
object[]

Custom fields for additional persona information

additionalProperties
object

Workspace-defined additional property values for this persona, keyed by property key.

Example:
primaryOfferingOId
string

Primary Offering to use as context when generating personas. If not provided, the primary company attached to the Workspace will be used.

Example:

"o_123456"

linkingStrategy
object

Strategy for linking this persona to offerings (products/services)

Response

Persona created successfully

_metadata
object
required
data
object
required