The Activity Schedule Object defines when a campaign or item runs. Use it to set a 24/7 schedule or custom day/hour rules.

Fields

Field	Type	Description
`mode`	String	`ALWAYS` (24/7) or `CUSTOM` (use rules).
`rules`	Array	List of Activity Schedule Rule objects. Required when `mode` is `CUSTOM`.
`time_zone`	String	Time zone for the schedule. Set to `null` to use the account default.

Campaign example

Use mode and rules to control when a campaign runs (day/hour scheduling).

{
   "activity_schedule": {
      "mode": "ALWAYS",
      "rules": [],
      "time_zone": "US/Eastern"
   }
}

{
   "activity_schedule": {
      "mode": "CUSTOM",
      "rules": [
         {
            "type": "INCLUDE",
            "day": "FRIDAY",
            "from_hour": 0,
            "until_hour": 14
         },
         {
            "type": "EXCLUDE",
            "day": "SATURDAY",
            "from_hour": 0,
            "until_hour": 24
         },
         {
            "type": "EXCLUDE",
            "day": "SUNDAY",
            "from_hour": 0,
            "until_hour": 24
         }
      ],
      "time_zone": "US/Eastern"
   }
}

📘
Custom schedule example

Runs Friday until 2 pm (included with custom hours).

Does not run Saturday or Sunday (excluded).

Runs all day on other days (default).

Item example

For items, use activity_schedule to specify the time zone for start_date and end_date.

{
   "start_date": "2026-02-01 08:00:00",
   "end_date": "2026-02-28 23:45:00",
   "activity_schedule": {
      "time_zone": "America/New_York"
   }
}

📘
The above item runs from February 1 at 8:00 AM to February 28 at 11:45 PM (America/New_York time zone).