type CronScheduleConfig = {
timezone: string // IANA timezone, e.g. America/New_York
frequency: string // "hourly", "daily" or "monthly"
minute_mode?: string // hourly: "every" (default) or "specific"
minute_interval?: number // hourly every: 5-59
minutes?: number[] // 0-59; hourly specific: at least 5 apart; daily and monthly: the first is used
hours?: number[] // daily and monthly: 0-23
weekdays?: number[] // daily: 0-6 (Sunday is 0), default every day
month_days?: number[] // monthly: 1-31
months?: number[] // monthly: 1-12, default every month
}
Schedule
Event triggerScheduling
Run a flow on a recurring schedule.
Options
ScheduleRequired
Choose when this flow should run.
Set up in the editor. The JSON format is under advanced documentation below.
Outputs
Timezone
The IANA timezone this schedule runs in.
Example: America/Los_Angeles
Frequency
The configured schedule frequency.
Example: daily
Summary
A human-readable summary of the schedule.
Example: Every week on Monday at 09:00
Scheduled For (UTC)
The UTC time this run was scheduled for.
Example: 2026-03-29T17:00:00Z
Scheduled For (Unix)
The Unix timestamp this run was scheduled for.
Example: 1774803600
Scheduled For (Local)
The scheduled local time in the selected timezone.
Example: 2026-03-29T10:00:00-07:00
Scheduled For Local (Unix)
The scheduled local time as a Unix timestamp.
Example: 1774803600
Triggered At
The UTC time the scheduler dispatched this run.
Example: 2026-03-29T17:00:01Z
Triggered At (Unix)
The Unix timestamp when the scheduler dispatched this run.
Example: 1774803601
Build a bot using triggers like Schedule
Use this trigger in our visual flow editor. Bots are hosted 24/7 for free on inventor.bot.
Advanced Documentation
This documentation can be useful when using code mode.
ID:
cron_scheduleOptions
| Field | InventScript name | Value |
|---|---|---|
| Schedule | cron_config | JSON text |
cron_config format: JSON text of type CronScheduleConfig. Fields marked ? are optional.Outputs
| Field | InventScript name | Value |
|---|---|---|
| Timezone | timezone | e.g. "America/Los_Angeles" |
| Frequency | frequency | e.g. "daily" |
| Summary | summary | e.g. "Every week on Monday at 09:00" |
| Scheduled For (UTC) | scheduled_for | e.g. "2026-03-29T17:00:00Z" |
| Scheduled For (Unix) | scheduled_for_unix | e.g. "1774803600" |
| Scheduled For (Local) | scheduled_for_local | e.g. "2026-03-29T10:00:00-07:00" |
| Scheduled For Local (Unix) | scheduled_for_local_unix | e.g. "1774803600" |
| Triggered At | triggered_at | e.g. "2026-03-29T17:00:01Z" |
| Triggered At (Unix) | triggered_at_unix | e.g. "1774803601" |
Example InventScript
var trigger = cron_schedule(Args{cron_config: `...`})
func main() {
send_text_message(Args{channel_id: "CHANNEL_ID", message_content: "Timezone: " + trigger.timezone})
}