Skip to main content

What is a campaign?

A campaign is an automated outreach sequence, a series of touchpoints across one or more channels (voice, SMS, email, LinkedIn, WhatsApp) that Sendora executes automatically for each enrolled lead. Each campaign has:
  • A status: draft, running, paused, completed or stopped
  • A set of enrolled leads (via lead lists or individual IDs)
  • A journey, the sequence of nodes and branching logic (configured in the dashboard or via API)
  • Analytics, reply rates, call durations, conversion events per variant

Campaign lifecycle

Creating a campaign

POST /api/v1/public/campaigns creates a campaign, or copies one (see Cloning).
The created campaign is in draft status. Configure it in the dashboard (nodes, schedule, send windows) or send a workflow, then launch it with the status field.

Changing a campaign

Settings, workflow, status and enrolled leads all change through one call: PATCH /api/v1/public/campaigns/{campaign_id}. Send only what you want to change. The steps run in this order: settings and workflow, status, enrollment, removals. If a step fails, the earlier steps stay applied and the error lists them under applied. The response is the updated campaign; when leads were enrolled it also carries enrollment with enrolled, skipped and total_requested.

Launching a campaign

Before launching, run a preflight check to catch configuration errors. Get the campaign with include=preflight:
The preflight object in the response:
Launching runs the same checks as the dashboard. A campaign that fails them is refused with 422 and plain sentences.

Enrolling leads

Enroll leads from explicit IDs or a whole lead list:
Both return the campaign with:
Leads already in the campaign are silently skipped (idempotent). You can enroll leads into a running campaign, they start their sequence immediately. To take leads out, send remove_lead_ids.

Pausing and resuming

Pause a campaign to temporarily stop outreach, and resume it later:
Pausing does not cancel in-flight actions, calls already dialed complete, but no new outreach is initiated until resumed. Asking for a status the campaign is already in changes nothing.

Stopping a campaign

Hard-stop a campaign and cancel all remaining journeys:
Stopped campaigns move to stopped status and cannot be resumed. Leads can be re-enrolled into a new or cloned campaign.

Cloning a campaign

Create an exact copy (draft status, no leads enrolled) with clone_from:
Useful for running the same sequence to a different audience, or A/B testing configurations.

Answering replies

A campaign has one reply setting for email, SMS and WhatsApp together. Set it when you create the campaign or later with the same update call:
Turning replies on without an agent answers 422. The agent keeps its own instructions, knowledge, tools, hours, hand-over words and sending limits in every campaign. A person can still take over one lead in the Inbox without changing the campaign.

Listing leads in a campaign

Supports filtering by enrollment status (pending, running, paused, completed, failed, cancelled, skipped, exited) and pagination with page and per_page.

Analytics

Returns reply rates, call connect rates, meeting booking rates, and email open/click metrics.

Webhook events

Subscribe to these events to react to campaign milestones: See Webhooks guide for setup.