Skip to content

Personas & Phases

Manage a campaign’s buyer personas and outreach phases — list, get, create, update, and delete.

Full name: campaignstack_list_personas

campaigns:read Read-only Idempotent

List all personas for a campaign. Personas define buyer archetypes with pain points, goals, and objections. Use campaignstack_list_campaigns to find valid campaign IDs.

NameTypeRequiredDefaultDescription
campaignIdstringYes(min length: 1)

Full name: campaignstack_get_persona

campaigns:read Read-only Idempotent

Get a persona by ID. Returns the full persona record including pain points, goals, and objections. If not found, use campaignstack_list_personas with a valid campaignId.

NameTypeRequiredDefaultDescription
personaIdstringYes(min length: 1)

Full name: campaignstack_create_persona

campaigns:write

Create a new persona in a campaign. Personas represent buyer archetypes with their pain points, goals, and objections. Use campaignstack_list_campaigns to find campaign IDs.

NameTypeRequiredDefaultDescription
campaignIdstringYes(min length: 1)
namestringYes(min length: 1)
descriptionstringNo
painPointsstring[]NoPain points this persona experiences
goalsstring[]NoGoals this persona is trying to achieve
objectionsstring[]NoCommon objections from this persona

Full name: campaignstack_update_persona

campaigns:write Idempotent

Update a persona’s name, description, pain points, goals, or objections. Only provided fields are updated. Returns the updated persona object.

NameTypeRequiredDefaultDescription
personaIdstringYes(min length: 1)
namestringNo(min length: 1)
descriptionstringNo
painPointsstring[]No
goalsstring[]No
objectionsstring[]No

Full name: campaignstack_delete_persona

campaigns:write Destructive

Permanently delete a persona. This action cannot be undone. Use campaignstack_list_personas to confirm the persona ID before deleting.

NameTypeRequiredDefaultDescription
personaIdstringYes(min length: 1)

Full name: campaignstack_list_phases

campaigns:read Read-only Idempotent

List all phases for a campaign, sorted by order. Phases represent roadmap milestones with objectives and a phase type. Use campaignstack_list_campaigns to find valid campaign IDs.

NameTypeRequiredDefaultDescription
campaignIdstringYes(min length: 1)

Full name: campaignstack_get_phase

campaigns:read Read-only Idempotent

Get a campaign phase by ID. Returns the full phase record including objectives, phase type, and order. If not found, use campaignstack_list_phases with a valid campaignId.

NameTypeRequiredDefaultDescription
phaseIdstringYes(min length: 1)

Full name: campaignstack_create_phase

campaigns:write

Create a new campaign phase (roadmap milestone). Phases organize a campaign into sequential steps with objectives. The order field controls phase sequencing. Use campaignstack_list_campaigns to find campaign IDs.

NameTypeRequiredDefaultDescription
campaignIdstringYes(min length: 1)
namestringYes(min length: 1)
descriptionstringYes(min length: 1)
objectivesstring[]Yes
phaseTypesourcing | outreach | content | intelligence | refinementNoOptional phase classification
orderintegerYes(min: 0)

Full name: campaignstack_update_phase

campaigns:write Idempotent

Update a campaign phase’s name, description, objectives, phase type, or order. Only provided fields are updated. Returns the updated phase object.

NameTypeRequiredDefaultDescription
phaseIdstringYes(min length: 1)
namestringNo(min length: 1)
descriptionstringNo
objectivesstring[]No
phaseTypesourcing | outreach | content | intelligence | refinementNo
orderintegerNo(min: 0)

Full name: campaignstack_delete_phase

campaigns:write Destructive

Permanently delete a campaign phase. This action cannot be undone. Use campaignstack_list_phases to confirm the phase ID before deleting.

NameTypeRequiredDefaultDescription
phaseIdstringYes(min length: 1)