Add Persona

Create a new buyer persona — describe it in plain English and Pendium builds the full profile.

POST /api/visibility/personas

Authentication: Required

Add a buyer persona that Pendium will use in future visibility scans. You have two options:

AI-generated (recommended): Describe the persona in a sentence or two, and Pendium expands it into a full profile with demographics, goals, pain points, and system context.
Manual: Provide all the fields yourself for full control.

Request body

AI-generated (recommended):

{
  "syntheticId": 1234,
  "prompt": "technical startup founder who evaluates developer tools and cares about API quality"
}

That's it. Pendium uses AI to build the full persona from your description.

Manual:

{
  "syntheticId": 1234,
  "name": "Technical Startup Founder",
  "role": "CTO / Co-founder",
  "goals": ["Find tools that scale", "Minimize context switching"],
  "painPoints": ["Too many tools", "Integration complexity"],
  "demographics": {
    "companySize": "10-50",
    "industry": "SaaS",
    "expertiseLevel": "expert"
  }
}

Field	Type	Required	Description
`syntheticId`	integer	Yes	The brand agent ID.
`prompt`	string	For AI generation	Natural language description. Pendium builds the full persona from this.
`name`	string	For manual creation	Display name for the persona.
`role`	string	No	Job title or role.
`goals`	string[]	No	What this persona is trying to achieve.
`painPoints`	string[]	No	Frustrations or challenges.
`demographics`	object	No	Optional: `companySize`, `industry`, `location`, `ageRange`, `expertiseLevel`.

Example

curl -X POST https://pendium.ai/api/visibility/personas \
  -H "Content-Type: application/json" \
  -H "x-api-key: pk_live_xxxxxxxxxxxx" \
  -d '{
    "syntheticId": 1234,
    "prompt": "enterprise procurement manager comparing vendor options for a 500-person company"
  }'

Response

{
  "success": true,
  "persona": {
    "id": "persona-uuid-new",
    "name": "Enterprise Procurement Manager",
    "role": "Procurement Lead",
    "goals": ["Reduce vendor sprawl", "Negotiate enterprise pricing"],
    "painPoints": ["Long evaluation cycles", "Security compliance requirements"],
    "demographics": {
      "companySize": "500+",
      "industry": "Enterprise",
      "expertiseLevel": "intermediate"
    }
  },
  "_pendium": {
    "what_happened": "Persona 'Enterprise Procurement Manager' created...",
    "next_steps": ["Trigger a scan to test queries from this persona's perspective..."]
  }
}

Tips

Be specific in your prompt. "startup founder" is okay, but "technical startup founder who evaluates developer tools and cares about API quality and documentation" gives Pendium much more to work with.
Think about who actually buys your product. The best personas map to real customer segments — not abstract demographics.
Add 2–4 personas. Enough to cover your key buyer types without making scans too expensive.

Request body

Example

Response

Tips

On this page