Campaigns

Manage marketing campaigns. Use action=“create” to create a new campaign (requires title). Use action=“update” to update an existing campaign (requires campaign_id). Use action=“list” to get campaigns with filters.

Input Schema

Parameter	Type	Description
action	string	Action to perform on campaigns. Enum: create, list, update
campaign_id	string	Campaign UUID (required for update)
title	string	Campaign title
description	string	Campaign description
status	string	Status (e.g. pending, active, completed)
type	string	Campaign type (e.g. email, social, ad)
priority	string	Priority (e.g. low, medium, high)
budget	object	Budget details
revenue	object	Revenue details
due_date	string	Due date (ISO string)
site_id	string	Filter by site UUID
user_id	string	Filter by user UUID
limit	number	Max results
offset	number	Pagination offset

REST Endpoint

Actions map to sub-routes: create → /create, list → /get, update → /update.


POST /api/agents/tools/campaigns/create
POST /api/agents/tools/campaigns/get
POST /api/agents/tools/campaigns/update


POST /api/agents/tools/campaigns/create
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
 
{
  "site_id": "YOUR_SITE_ID",
  "title": "Q1 Outreach Campaign",
  "type": "email",
  "status": "active",
  "priority": "high"
}

Response:


{
  "success": true,
  "campaign": { "id": "...", "title": "Q1 Outreach Campaign" }
}