Personas & Phases

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

Tools (10)

list_personas

Full name: campaignstack_list_personas

campaigns:read Read-only Idempotent

List all personas for a campaign: buyer archetypes with pain points, goals, and objections. Call this when the user asks who a campaign targets. Not the roadmap: campaignstack_list_phases covers that. Use campaignstack_list_campaigns for campaign IDs.

Parameters

Name	Type	Required	Default	Description
`campaignId`	string	Yes	—	(min length: 1)

get_persona

Full name: campaignstack_get_persona

campaigns:read Read-only Idempotent

Get a persona by ID: pain points, goals, and objections. Call this when you need its full detail before editing it. Not a list: campaignstack_list_personas finds the ID.

Parameters

Name	Type	Required	Default	Description
`personaId`	string	Yes	—	(min length: 1)

create_persona

Full name: campaignstack_create_persona

campaigns:write

Create a persona in a campaign: a buyer archetype with pain points, goals, and objections. Call this when the user describes a buyer type to add. It does not filter or score leads, only shapes generated copy. Use campaignstack_list_campaigns for campaign IDs.

Parameters

Name	Type	Required	Default	Description
`campaignId`	string	Yes	—	(min length: 1)
`name`	string	Yes	—	(min length: 1)
`description`	string	No	—
`painPoints`	string[]	No	—	Pain points this persona experiences
`goals`	string[]	No	—	Goals this persona is trying to achieve
`objections`	string[]	No	—	Common objections from this persona

update_persona

Full name: campaignstack_update_persona

campaigns:write

Update a persona’s name, description, pain points, goals, or objections; only provided fields change. Call this when the user revises an existing persona. Not for creating one: campaignstack_create_persona does that. Use campaignstack_list_personas to find the ID.

Parameters

Name	Type	Required	Default	Description
`personaId`	string	Yes	—	(min length: 1)
`name`	string	No	—	(min length: 1)
`description`	string	No	—
`painPoints`	string[]	No	—
`goals`	string[]	No	—
`objections`	string[]	No	—

delete_persona

Full name: campaignstack_delete_persona

campaigns:write Destructive

Permanently delete a persona; no restore tool exists. Call this only when the user explicitly asks to remove one, not merely edit it (campaignstack_update_persona instead). Use campaignstack_list_personas to confirm the ID first.

Parameters

Name	Type	Required	Default	Description
`personaId`	string	Yes	—	(min length: 1)

list_phases

Full name: campaignstack_list_phases

campaigns:read Read-only Idempotent

List all phases for a campaign, sorted by order: roadmap milestones with objectives and a phase type. Call this when the user asks about a campaign’s roadmap. Not personas: campaignstack_list_personas is the buyer side. Use campaignstack_list_campaigns for campaign IDs.

Parameters

Name	Type	Required	Default	Description
`campaignId`	string	Yes	—	(min length: 1)

get_phase

Full name: campaignstack_get_phase

campaigns:read Read-only Idempotent

Get a campaign phase by ID: objectives, phase type, and order. Call this when you need its full detail before editing it. Not a list: campaignstack_list_phases finds the ID.

Parameters

Name	Type	Required	Default	Description
`phaseId`	string	Yes	—	(min length: 1)

create_phase

Full name: campaignstack_create_phase

campaigns:write

Create a campaign phase (roadmap milestone); order controls sequencing. Call this when the user describes a new stage to add. It does not build any workflow: campaignstack_create_workflow does that. Use campaignstack_list_phases first to pick an order.

Parameters

Name	Type	Required	Default	Description
`campaignId`	string	Yes	—	(min length: 1)
`name`	string	Yes	—	(min length: 1)
`description`	string	Yes	—	(min length: 1)
`objectives`	string[]	Yes	—
`phaseType`	`sourcing` \| `outreach` \| `content` \| `intelligence` \| `refinement`	No	—	Optional phase classification
`order`	integer	Yes	—	(min: 0)

update_phase

Full name: campaignstack_update_phase

campaigns:write

Update a phase’s name, description, objectives, phase type, or order; only provided fields change. Call this when the user reorders the roadmap or revises objectives. Not for creating one: campaignstack_create_phase does that. Use campaignstack_list_phases to find the ID.

Parameters

Name	Type	Required	Default	Description
`phaseId`	string	Yes	—	(min length: 1)
`name`	string	No	—	(min length: 1)
`description`	string	No	—
`objectives`	string[]	No	—
`phaseType`	`sourcing` \| `outreach` \| `content` \| `intelligence` \| `refinement`	No	—
`order`	integer	No	—	(min: 0)

delete_phase

Full name: campaignstack_delete_phase

campaigns:write Destructive

Permanently delete a campaign phase; no restore tool exists. Call this only when the user asks to remove one, not to reorder it (campaignstack_update_phase does that). Use campaignstack_list_phases to confirm the ID first.

Parameters

Name	Type	Required	Default	Description
`phaseId`	string	Yes	—	(min length: 1)