Skip to content

create_campaign

Start a new campaign

Act · mcp:actIdempotent

Opens one more campaign in the workspace, as an empty draft, and makes it the current one — only when the user asked for a new campaign, under the name they gave or approved. Nothing is bought or sent.

Description the model readsSent as is in tools/list.
Open one more campaign in the workspace, as an empty draft, and make it the current one — only when the user asked for a new campaign, under the name they gave or approved. It starts with no target, playbook, sequence or leads of its own; the offer, plan and sending setup are the workspace's. Nothing is bought or sent. Calling it again with the same name returns the campaign already opened.

The user says

Start a new campaign called “Clinics BE — Q1”.

tools/call · Arguments the assistant sends
{
"name": "create_campaign",
"arguments": {
"name": "Clinics BE — Q1"
}
}
namestringrequired1–120 chars

The campaign name, as the user gave or approved it.

Input schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "The campaign name, as the user gave or approved it."
}
},
"required": ["name"]
}

Result kindcampaign_update

kind"campaign_update"
outcomestring

What happened, in a sentence.

campaignobject
  • id string — The campaign id: pass it to select_campaign or rename_campaign.
  • name string
  • state string — The campaign state code.
  • stateLabel string — The campaign state, in words.
  • current boolean — True for the campaign every tool of this connection works on right now.
  • mailboxes integer — Sending mailboxes assigned to it.
appUrlstring
Output schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "campaign_update"
},
"outcome": {
"type": "string",
"description": "What happened, in a sentence."
},
"campaign": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The campaign id: pass it to select_campaign or rename_campaign."
},
"name": {
"type": "string"
},
"state": {
"type": "string",
"description": "The campaign state code."
},
"stateLabel": {
"type": "string",
"description": "The campaign state, in words."
},
"current": {
"type": "boolean",
"description": "True for the campaign every tool of this connection works on right now."
},
"mailboxes": {
"type": "integer",
"description": "Sending mailboxes assigned to it."
}
},
"required": ["id", "name", "state", "stateLabel", "current", "mailboxes"],
"additionalProperties": false
},
"appUrl": {
"type": "string"
}
},
"required": ["kind", "outcome", "campaign", "appUrl"],
"additionalProperties": false
}
  • It starts with no target, playbook, sequence or leads of its own; the offer, the plan and the sending setup are the workspace's.
  • Calling it again with the same name returns the campaign already opened, current again.
  • Refused when list_campaigns says canCreate is false.