Skip to main content
POST
/
personas
/
suggestions
cURL
curl -X POST https://app.mavera.io/api/v1/personas/suggestions \
  -H "Authorization: Bearer mvra_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "business_description": "B2B SaaS platform for marketing automation",
    "target_customers": ["Marketing Managers", "CMOs", "Growth Teams"],
    "goals": ["Increase conversions", "Reduce CAC", "Scale campaigns"]
  }'
{
  "object": "list",
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "type": "B2B",
      "category": "<string>",
      "description": "<string>",
      "goals": [
        "<string>"
      ],
      "pains": [
        "<string>"
      ],
      "channels": [
        "<string>"
      ],
      "triggers": [
        "<string>"
      ],
      "buying_stage": "<string>",
      "decision_role": "<string>",
      "confidence": 123,
      "rationale": "<string>"
    }
  ],
  "input_summary": {
    "business_description": "<string>",
    "target_customers": [
      "<string>"
    ],
    "goals": [
      "<string>"
    ],
    "sources_count": 123
  }
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
business_description
string
required

A brief description of your business or product.

Required string length: 10 - 500
Example:

"B2B SaaS platform for marketing automation targeting mid-market companies"

​
target_customers
string[]
required

Types of customers you're targeting.

Required array length: 1 - 10 elements
Example:
[
  "Marketing Managers",
  "CMOs",
  "Growth Teams"
]
​
goals
string[]
required

Primary business or marketing goals.

Required array length: 1 - 10 elements
Example:
[
  "Increase conversions",
  "Reduce CAC",
  "Scale campaigns"
]
​
sources
object[]

Optional sources (URLs or file references) to inform persona generation.

Response

Persona suggestions generated successfully.

​
object
enum<string>
Available options:
list
Example:

"list"

​
data
object[]

Generated persona suggestions.

​
input_summary
object

Summary of input used for generation.