Skip to main content
Control when a campaign begins and what hours it’s allowed to place calls.

One-time start

Choose a future date and time to have a draft campaign start automatically, instead of starting it manually.
When you create a campaign through the API, omit scheduling fields to create a draft. Provide both scheduled_date and scheduled_time to create a scheduled campaign. See Run a campaign with the API for an end-to-end example.

Stop a scheduled start

If a campaign is scheduled but not ready yet, you can stop it from starting automatically. Open the campaign while it’s scheduled and choose one of these:
  • Hold schedule keeps the scheduled start time and stops the campaign from starting automatically. The badge shows Schedule on hold. While it’s on hold you can change the start time, edit the call workflow, and change retry settings. When you’re ready, click Resume schedule to turn auto-start back on. Resuming doesn’t dial right away: the campaign starts at its scheduled time, or shortly after you resume if that time has already passed.
  • Convert to draft removes the scheduled start time and makes the campaign a draft, which you start manually with Start Campaign. You can still schedule it again later. Find it in the campaign’s More actions menu or in Edit Schedule. It also works on a campaign whose schedule is on hold.
Both are only available before the campaign starts. Once it’s running, use Pause Campaign instead.
Same-day follow-up attempts in a call workflow need a scheduled start time, so a campaign with same-day follow-ups can’t be converted to draft as it is. Either edit the workflow first, or choose Remove same-day follow-ups and convert to draft in the confirmation. If you want to keep same-day follow-ups, use Hold schedule instead.
Through the API, POST /api/campaigns/{id}/hold-schedule and POST /api/campaigns/{id}/resume-schedule hold and resume a schedule, and DELETE /api/campaigns/{id}/schedule converts a campaign to draft. If the campaign has already started, these return 409.

Recurring working hours

Set working hours to restrict the campaign to a recurring daily calling window. Working hours use the campaign timezone unless you choose a separate override.
A campaign automatically pauses outside its configured working hours and resumes at the start of the next window — if a campaign looks stalled, check whether it’s simply outside its working hours before assuming something is wrong.

Next steps

Monitor your campaign once it’s running.