Create a custom AI-powered persona using one of three pipeline types:
North Star (north_star): Quick AI-generated persona from minimal input. First call /personas/suggestions to get options, then create with the selected suggestion.
Intermediate (intermediate): Guided persona with structured fields for goals, pains, channels, and market alignment.
Advanced (advanced): Full-featured persona with B2B/B2C specifics, psychographics, and purpose packs.
Pricing: 300 credits per persona created.
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>"
}
}API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.
Create a custom persona using one of three pipeline types. Each pipeline has different required fields - see the individual schemas for details.
Must be 'north_star' for this pipeline.
north_star "north_star"
REQUIRED: The selected suggestion from /personas/suggestions endpoint.
Show child attributes
Original business description (optional, for context).
Original target customers (optional).
Optional sources for additional context.
Show child attributes
Custom persona created successfully.
Unique persona ID.
custom_persona "custom_persona"
north_star, intermediate, advanced B2B, B2C true
Unix timestamp.
Credits charged for creation.
300
Detailed custom persona fields.
Show child attributes
Show child attributes
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>"
}
}