Update Campaign

Update campaign status, schedule, or priority.

Endpoint

POST https://www.tabbly.io/dashboard/agents/endpoints/update-campaign

Authentication

See Introduction. This is a POST endpoint — include api_key in the JSON request body. Your organization_id must match the organization linked to your API key.

Request body

Field	Type	Required	Description
`api_key`	string	Yes	Your organization API key
`organization_id`	integer	Yes	Your organization ID
`id`	integer	Yes	Campaign ID to update
`current_status`	string	No	`Active` or `Paused`
`start_time`	string	No	`YYYY-MM-DD HH:MM:SS` (UTC)
`end_time`	string	No	`YYYY-MM-DD HH:MM:SS` (UTC)
`priority`	string	No	Campaign priority. Pass `null` or an empty string to clear

Only include fields you want to change. Omitted fields are left unchanged.

Example request

curl -X POST "https://www.tabbly.io/dashboard/agents/endpoints/update-campaign" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "organization_id": 3282,
    "id": 2744,
    "current_status": "Paused",
    "start_time": "2026-06-24 09:00:00",
    "end_time": "2026-06-24 18:00:00",
    "priority": "high"
  }'

Response

Success (200)

{
  "success": true,
  "message": "Campaign updated successfully",
  "data": {
    "id": 2744,
    "organization_id": 3282,
    "current_status": "Paused",
    "start_time": "2026-06-24 09:00:00",
    "end_time": "2026-06-24 18:00:00",
    "priority": "high",
    "updated_at": "2026-06-23 13:06:21"
  }
}

Error responses

{
  "error": "Human-readable error description"
}

HTTP status	When
400	Missing required fields, invalid status, invalid date format
401	Invalid API key or `organization_id` mismatch
404	Campaign not found or does not belong to organization
405	Method not POST

Valid values

`current_status`

Active, Paused

Notes

Times are stored and returned in UTC.
priority can be set to any string value, or cleared by sending null or "".