add_persona

Add a buyer persona for visibility scans — either AI-generated from a prompt or manually specified.

Add a buyer persona for visibility scans. Two modes:

Recommended — AI-generated: Provide a prompt describing the buyer type. Pendium uses AI to expand it into a full persona with demographics, goals, pain points, and system context.
Manual: Provide structured fields directly.

New personas are used in the next scan to test how AI platforms respond from this buyer's perspective.

Authentication: Required

Parameters

Parameter	Type	Required	Description
`syntheticId`	`integer`	Yes	The agent ID to add the persona to.
`prompt`	`string`	One of `prompt` or `name`	Describe the buyer type in natural language. Pendium expands this into a full persona.
`name`	`string`	One of `prompt` or `name`	Manual mode: persona name (e.g., `"Enterprise CMO"`).
`role`	`string`	No	Manual mode: job title or role.
`goals`	`string[]`	No	Manual mode: what this persona is trying to achieve.
`painPoints`	`string[]`	No	Manual mode: challenges and frustrations.

AI-generated example

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

Response:

{
  "success": true,
  "syntheticId": 1234,
  "generatedFrom": "technical startup founder who evaluates developer tools and cares about API quality",
  "persona": {
    "id": "persona-new",
    "name": "API-First Technical Founder",
    "role": "CTO / Technical Co-Founder",
    "demographics": "28-42, computer science background, 5-15 years engineering experience",
    "goals": [
      "Find tools with robust, well-documented APIs",
      "Integrate visibility monitoring into CI/CD pipeline",
      "Minimize time spent on marketing tasks"
    ],
    "painPoints": [
      "Most marketing tools have poor APIs",
      "Hates vendor lock-in and closed ecosystems",
      "No time to manually check AI platform mentions"
    ],
    "systemContext": "You are a technical startup founder who evaluates tools primarily by API quality...",
    "isActive": true
  }
}

Manual example

{
  "syntheticId": 1234,
  "name": "Enterprise CMO",
  "role": "Chief Marketing Officer",
  "goals": ["Increase brand visibility across AI platforms", "Measure ROI on content investments"],
  "painPoints": ["Hard to track AI mentions at scale", "Reporting to the board on AI readiness"]
}

The AI-generated mode produces richer personas with demographics, system context, and more detailed goals/pain points. Use manual mode when you have a specific persona definition you want to preserve exactly.

Parameters

AI-generated example

Manual example

On this page