Skip to main content
POST
/
personas
cURL (Intermediate)
curl -X POST https://app.mavera.io/api/v1/personas \
  -H "Authorization: Bearer mvra_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "pipeline_type": "intermediate",
    "name": "Enterprise CMO",
    "type": "B2B",
    "role_segment": ["CMO", "VP Marketing"],
    "buying_stage": "SOLUTION_AWARE",
    "decision_role": "ECONOMIC_BUYER",
    "primary_objectives": ["Drive revenue growth", "Optimize marketing spend"],
    "mcda_weights": {"price": 3, "timeToValue": 4, "risk": 2, "proof": 5, "support": 3},
    "goals": ["Increase marketing ROI", "Scale demand generation"],
    "pains": ["Attribution challenges", "Budget constraints", "Tech stack complexity"],
    "triggers": ["New fiscal year", "Board pressure", "Competitor threat"],
    "channels": ["LinkedIn", "Industry events", "Peer referrals"],
    "proof_types": ["Case studies", "ROI calculators", "Peer references"],
    "alternatives": ["HubSpot", "Marketo", "In-house solution"],
    "win_factors": ["Time to value", "Integration ease", "Support quality"],
    "objections": ["Implementation time", "Team adoption", "Data migration"]
  }'
{
  "id": "<string>",
  "object": "custom_persona",
  "name": "<string>",
  "category": "<string>",
  "description": "<string>",
  "pipeline_type": "north_star",
  "type": "B2B",
  "is_custom": true,
  "created_at": 123,
  "credits_charged": 300,
  "details": {
    "pipeline_type": "<string>",
    "persona_type": "<string>",
    "primary_use_case": "<string>",
    "buying_stage": "<string>",
    "decision_role": "<string>",
    "role_segment": [
      "<string>"
    ],
    "primary_objectives": [
      "<string>"
    ],
    "mcda_weights": {},
    "goals": [
      "<string>"
    ],
    "pains": [
      "<string>"
    ],
    "triggers": [
      "<string>"
    ],
    "channels": [
      "<string>"
    ],
    "proof_types": [
      "<string>"
    ],
    "alternatives": [
      "<string>"
    ],
    "win_factors": [
      "<string>"
    ],
    "objections": [
      "<string>"
    ],
    "values": [
      "<string>"
    ],
    "proof_preferences": [
      "<string>"
    ],
    "brand_voice_fit": "<string>",
    "reading_level": "<string>",
    "tone_guardrails": [
      "<string>"
    ],
    "role_title": "<string>",
    "seniority": "<string>",
    "industry": "<string>",
    "company_size": "<string>",
    "tech_stack": [
      "<string>"
    ],
    "budget_authority": "<string>",
    "procurement_constraints": [
      "<string>"
    ],
    "committee_mapping": [
      "<string>"
    ],
    "life_stage": "<string>",
    "age_band": "<string>",
    "income_band": "<string>",
    "household_context": [
      "<string>"
    ],
    "lifestyle_affinities": [
      "<string>"
    ],
    "purchase_cadence": "<string>",
    "key_differentiators": [
      "<string>"
    ],
    "regulatory_context": [
      "<string>"
    ],
    "is_localized": true,
    "locale_scope": "<string>",
    "locale_value": "<string>",
    "local_channels": [
      "<string>"
    ],
    "local_objections": [
      "<string>"
    ],
    "local_keywords": [
      "<string>"
    ],
    "price_sensitivity_delta": 123,
    "purpose_packs_enabled": {},
    "acquisition_config": {},
    "pmm_config": {},
    "content_config": {},
    "sales_config": {},
    "research_config": {}
  },
  "ai_generated": {
    "confidence": 123,
    "rationale": "<string>"
  }
}

Authorizations

Authorization
string
header
required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Body

application/json

Create a custom persona using one of three pipeline types. Each pipeline has different required fields - see the individual schemas for details.

pipeline_type
enum<string>
required

Must be 'north_star' for this pipeline.

Available options:
north_star
Example:

"north_star"

suggestion
object
required

REQUIRED: The selected suggestion from /personas/suggestions endpoint.

business_description
string

Original business description (optional, for context).

target_customers
string[]

Original target customers (optional).

sources
object[]

Optional sources for additional context.

Response

Custom persona created successfully.

id
string

Unique persona ID.

object
enum<string>
Available options:
custom_persona
Example:

"custom_persona"

name
string
category
string
description
string
pipeline_type
enum<string>
Available options:
north_star,
intermediate,
advanced
type
enum<string> | null
Available options:
B2B,
B2C
is_custom
boolean
Example:

true

created_at
integer

Unix timestamp.

credits_charged
integer

Credits charged for creation.

Example:

300

details
object

Detailed custom persona fields.

ai_generated
object