Campaigns

Campaign Scheduling

Control when your campaigns send emails by configuring time windows, days of the week, and timezone-aware schedules.

Schedule Configuration

Each campaign can have a schedule that restricts sending to specific days and hours:

Example: Business hours EST

{
  "timezone": "America/New_York",
  "send_window_start": "09:00",
  "send_window_end": "17:00",
  "send_days": "1,2,3,4,5"
}

Fields

Field	Type	Description
`send_days`	Comma-separated string	1=Monday, 2=Tuesday, ..., 7=Sunday
`send_window_start`	String (HH:MM)	Start of sending window
`send_window_end`	String (HH:MM)	End of sending window
`timezone`	IANA timezone	e.g., America/New_York, Europe/London, Asia/Tokyo

Overnight Schedules

Schedules where start is after end are treated as overnight windows:

Example: Evening to morning

{
  "days": [1, 2, 3, 4, 5],
  "start": "22:00",
  "end": "06:00",
  "timezone": "UTC"
}

This sends from 10 PM to 6 AM UTC on weekdays.

No Schedule (24/7)

If you leave the send window and days at defaults (09:00–17:00, Mon–Fri), the campaign uses these defaults. The dispatcher always checks the window in the campaign's configured timezone.

Scheduled Start (Delayed Launch)

Set a scheduled_start_at timestamp (ISO 8601) to delay campaign start. The campaign must be in "active" status, but the dispatcher won't process leads until the scheduled time arrives.

Timezone tip

Always set the timezone to match your recipients' location, not your own. Sending during their business hours dramatically improves open rates.