Skip to content
ajan.io

Docs menu

On this page

Scheduled Trigger

Run workflows automatically on a recurring schedule with flexible timing options.

Overview

The Scheduled Trigger runs your workflow automatically at specified times or intervals. Whether you need daily reports, hourly data syncs, or monthly cleanup tasks, scheduled workflows handle recurring automations reliably.

When to Use Scheduled Trigger

Perfect for:

  • Daily, weekly, or monthly reports
  • Periodic data synchronization between systems
  • Scheduled data analysis and insights
  • Recurring maintenance or cleanup tasks
  • Time-based monitoring and alerts

Not ideal for:

  • Event-driven workflows (use Webhook or Integration Trigger)
  • User-initiated processes (use Manual or Form Trigger)
  • Real-time data processing

Configuration

Schedule Options

Quick Schedules (Visual Builder)

  • Every few minutes
  • Every hour
  • Every day at specific time
  • Every week on specific days
  • Every month on specific date
  • Prompt custom time interval

Cron Expression

Under the hood, all schedules are stored as cron expressions - a standard format for defining recurring schedules. The UI provides quick schedule options for convenience, but the underlying data is a 5-field cron string.

Cron format: minute hour day-of-month month day-of-week

FieldAllowed Values
Minute0-59
Hour0-23
Day of month1-31
Month1-12
Day of week0-6 (Sunday = 0)

Example cron expressions:

ScheduleCron Expression
Every day at 9 AM0 9 * * *
Every hour0 * * * *
Every Monday at 8 AM0 8 * * 1
First of every month at midnight0 0 1 * *
Every 15 minutes*/15 * * * *

Timezone

Set the timezone for your schedule:

  • Defaults to your account timezone
  • Supports all standard timezones
  • Critical for globally distributed teams

Example Use Cases

Daily Sales Report

text
Scheduled Trigger (Daily at 9 AM)
β†’ HTTP Request: Fetch yesterday's sales data
β†’ Code: Calculate metrics (total, growth, top products)
β†’ Agent: Generate executive summary
β†’ Notification: Email report to sales team

Hourly Data Sync

text
Scheduled Trigger (Every hour)
β†’ HTTP Request: Fetch new records from API
β†’ Loop: For each record
  β†’ Code: Transform data format
  β†’ HTTP Request: POST to destination system
β†’ Notification: Summary of records synced

Weekly Cleanup Task

text
Scheduled Trigger (Weekly on sunday)
β†’ HTTP Request: Fetch records older than 90 days
β†’ Loop: For each old record
  β†’ HTTP Request: Archive to cold storage
  β†’ HTTP Request: Delete from active database
β†’ Notification: Cleanup summary

Monthly Billing

text
Scheduled Trigger (1st of the month)
β†’ HTTP Request: Get all active subscriptions
β†’ Loop: For each subscription
  β†’ Code: Calculate billing amount
  β†’ HTTP Request: Create invoice
  β†’ Action: Send invoice email
β†’ Notification: Billing run complete

Testing Scheduled Workflows

Manual Test Runs

  1. Click on the Scheduled Trigger node
  2. Click "Test" to trigger a one-time run
  3. Review execution with current timestamp
  4. Verify time-based logic works correctly

Best Practices

Schedule resource-intensive workflows during off-peak hours (nights, weekends) to minimize impact on systems.

Always include error notifications for scheduled workflows. You won't be watching when they run.

If your system is down during a scheduled run, decide if you need to catch up or skip the missed execution.

Test your workflow with different timestamps to ensure time-based logic works correctly (e.g., end of month, leap years).

Don't schedule more frequently than needed. Every 5 minutes might be excessive - consider if hourly would work.

Track how long your scheduled workflows take. If execution time is close to the interval, you risk overlaps.

Troubleshooting

Check:

  • Workflow is deployed (not draft)
  • Workflow is active
  • Schedule is correctly configured
  • Monthly limit has not been reached

Check:

  • Timezone setting matches expectation
  • Cron expression is correct
  • Daylight saving time changes (use UTC to avoid)

Solutions:

  • Break into smaller workflows
  • Increase schedule interval
  • Optimize slow nodes (batch AI calls, parallel requests)

Next Steps