Persona

The persona endpoints let you define one or more ideal customer profiles (ICPs) for your workspace — each persona is a distinct business line. Personas drive signal scoring, account prioritization, and content generation across the platform.

Endpoints

• Create persona: POST /api/v2/personas — create a new persona (business line).
• List personas: GET /api/v2/personas — paginate your workspace's personas.
• Get persona: GET /api/v2/personas/{persona_id} — retrieve a single persona by id.
• Update persona: PATCH /api/v2/personas/{persona_id} — partially update a persona.

Deprecated

• Get persona (deprecated): GET /api/v2/persona — always reads your workspace's oldest persona. Use Get persona or List personas instead.
• Upsert persona (deprecated): PUT /api/v2/persona — always replaces your workspace's oldest persona, so it cannot create a second business line. Use Create persona to create one and Update persona to update one instead.

Both deprecated endpoints keep answering and will be removed in a future major version.