Scheduled triggers

Configure scheduled triggers to run agents at recurring times using cron expressions or fixed intervals for reports, syncs, and cleanup.

Scheduled triggers run agents at regular times without an event. Use them for recurring tasks like daily reports, weekly cleanup, or periodic syncs.

Schedule types

Cron

Run at specific times using a cron expression:

{
  "schedule_type": "cron",
  "cron_expression": "0 9 * * MON-FRI"
}

Standard 5-field cron format: minute hour day-of-month month day-of-week.

Example	Schedule
0 9 * * *	Every day at 9:00 AM
0 9 * * MON-FRI	Weekdays at 9:00 AM
0 */2 * * *	Every 2 hours
0 0 1 * *	First day of each month at midnight

Interval

Run at a fixed interval in seconds:

{
  "schedule_type": "interval",
  "interval_seconds": 3600
}

The minimum interval is 60 seconds.

Configuration

Field	Type	Required	Description
schedule_type	"cron" or "interval"	Yes	Type of schedule
cron_expression	string	When cron	Standard cron expression
interval_seconds	integer	When interval	Seconds between runs (minimum 60)

Validation

• cron_expression is required when schedule_type is "cron"
• interval_seconds is required when schedule_type is "interval"
• Interval must be at least 60 seconds

Schedule info

Once a scheduled agent is created, you can query its next run times through the GraphQL API. The ScheduleInfo type returns upcoming execution times.

Next steps

• Event triggers. Trigger agents from commerce events instead of schedules
• Agent Builder overview. Learn how triggers, steps, and actions fit together