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

{
  "days": [1, 2, 3, 4, 5],
  "start": "09:00",
  "end": "17:00",
  "timezone": "America/New_York"
}

Fields

Field	Type	Description
`days`	Array of integers	0=Sunday, 1=Monday, ..., 6=Saturday
`start`	String (HH:MM)	Start of sending 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 schedule empty or don't set it, the campaign sends 24/7 whenever leads are ready.

Launch At (Delayed Start)

Set a launch_at timestamp to delay campaign start. The campaign must be in "running" status, but it won't process leads until the launch 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.