Campaign statuses
Campaigns show a status tag that tells you whether the campaign is running and, when something goes wrong, why. The two campaign builders use different status sets, so this page keeps them separate: Flows campaigns on Campaigns > Flows, and Python campaigns on Campaigns > Python.
In both builders the status appears as a colored tag in the campaign list and in the campaign header, and the action button next to it changes with the status. On the Flows list, hovering over the tag shows its message — for an Error, the message names the cause. Python campaign tags show no message on hover — use Show Logs in the campaign's more-actions menu.
Flows campaign statuses
A Flows campaign processes triggers and schedules communications only while it is Active. New campaigns start as Inactive. You move between Inactive and Active with the Start / Stop button in the campaign header.
| Status | Color | Meaning | How it gets here | What to do |
|---|---|---|---|---|
| Inactive | Amber | The campaign is not processing events. Flows and data can be edited. | A new campaign is created here, or you clicked Stop. | Build and activate a flow, then click Start. |
| Active | Green | The campaign is running: triggers fire and communications are scheduled. The active flow is read-only. | You clicked Start with at least one flow active. | Monitor the Participants and Analytics tabs. Click Stop to edit again. |
| Error | Red | The campaign hit an error and cannot proceed. | A problem during processing — most often a channel that is not running or an agent that is stopped or in Error. | In the campaign list, hover over the tag to read the message, fix the cause, then click Start. See below. |
Only Inactive campaigns can be started, and only Active campaigns can be stopped. There is no separate pause action — Stop returns the campaign to Inactive and makes flows editable again.
Recover a Flows campaign from Error
- In the campaign list, hover over the Error tag to read the message — it carries the most recent error for the campaign.
- Check the channel the campaign sends through in Settings > Channels and confirm it is running.
- Check that the agents used by the flow's communication actions are running and not in Error — see Agent statuses.
- Fix the cause, then click Start to return the campaign to Active.
For the full start, stop, and troubleshooting workflow, see Flows.
Python campaign statuses
A Python campaign moves through a fixed lifecycle as you configure it. It runs only while it is Running, and the Start / Stop button changes with the status.
| Status | Color | Meaning | How it gets here | What to do |
|---|---|---|---|---|
| Created | Gray | The campaign exists but is not ready to run — contacts or a Data Load strategy are still missing. | A new campaign is created here. | Add stages, upload a Data Load strategy, and upload contacts. |
| Configured | Orange | The campaign has contacts and a Data Load strategy and is ready to start. | The campaign has both contacts and a Data Load strategy. | Click Start to begin processing contacts. |
| Running | Green | The campaign is processing contacts and sending communications in their planned time windows. | You clicked Start on a Configured campaign. | Track progress on the Contacts tab. Click Stop to pause. |
| Error | Red | The campaign cannot proceed. | A problem during processing. | Click Force stop, read Show Logs in the more-actions menu, and fix the cause. See below. |
The button reads Start for Created and Configured, Stop for Running, and Force stop for Error. Start stays unavailable until the campaign has contacts. There is no separate restart action — click Stop, then Start.
Recover a Python campaign from Error
- Click Force stop to halt processing.
- Open Show Logs in the more-actions menu to read the campaign engine log, including strategy output and exceptions, and fix the cause.
- Click Start to run the campaign again.
For the full setup, start, and stop workflow, see Python campaigns.
Notes
- A Python campaign stays in Created until it has both contacts and a Data Load strategy; only then does it become Configured and ready to start.
- For a Flows Error, hover over the tag in the campaign list to read the message before you start troubleshooting. For Python campaigns, use Show Logs in the more-actions menu.
- These campaign statuses are separate from the per-communication statuses tracked inside a campaign — those are listed on the Flows and Python campaigns pages.
Related pages
- Flows — build and run visual campaigns
- Python campaigns — the code-based campaign builder
- Agent statuses — the statuses of the agents campaigns send through
- Settings > Channels — the channel connections campaigns send through