Skip to main content

Schedules

Automate pipelines, tasks, and orchestrations to run at specified times.

Overview​

Schedules allow you to run pipelines, tasks, and orchestrations automatically at recurring intervals. Choose from preset frequencies (every few minutes, hourly, daily, weekly, monthly) or define custom cron expressions.

Each schedule targets one entity (pipeline, task, or orchestration) and shows last run status and next run time.

Common use cases:

  • Run nightly ETL at 3 AM daily
  • Sync Salesforce data every 15 minutes during business hours
  • Generate weekly reports every Monday morning
  • Refresh dashboards hourly

Prerequisites: At least one active pipeline, task, or orchestration.

To access: Navigate to Schedules in the sidebar, then click + Create Schedule.

Schedule Availability

Schedules require a trial or paid plan. Free plan users cannot create schedules.

Creating a Schedule​

To start:

  1. Navigate to Schedules in the sidebar
  2. Click + Create Schedule
  3. The schedule creation form opens (single-page form)

Select What to Run​

  1. Click the "Select what to run" dropdown
  2. Choose category:
    • Replication Pipelines (ingestion pipelines)
    • Activation Pipelines
    • Tasks
    • Orchestrations
  3. Select the specific pipeline, task, or orchestration from the list

Choose Frequency​

Available frequencies:

  • Every few minutes (PRO) - Run every 5, 10, 15, or 30 minutes
  • Hourly (PRO) - Run every 1, 2, 3, 4, 6, or 12 hours
  • Daily - Run once per day at a specific time
  • Weekly - Run on specific day(s) at a specific time
  • Monthly - Run on a specific day of the month at a specific time
  • Custom cron expression (PRO) - Enter any valid cron expression

Configure timing:

  • Select time of day (hour and minute)
  • Choose days of week (S M T W T F S buttons)
  • For minute/hourly schedules: choose time range (All day, Business hours, or Custom)

Schedule Summary panel:

  • Shows human-readable description (e.g., "Every 30 minutes, 9 AM - 5 PM, Monday-Friday")
  • Displays cron expression
  • Shows next 5 run times in your timezone

Name & Save​

Schedule Name (auto-generated, editable): Generated from frequency and target (e.g., "Daily: End to End Ingestion Transformation and Activation")

Description (auto-generated, editable): Full description of what runs and when (e.g., "Runs End to End Ingestion Transformation and Activation (orchestration) every 30 minutes, 9 am - 5 pm, monday-friday")

To create: Click Create schedule.

Managing Schedules​

The schedules list shows all your schedules with columns for NAME, SCHEDULE, LAST RUN, NEXT RUN, TARGET, and STATE. Click the three-dot menu (•••) on any schedule row to access management options.

Edit Schedule​

Modify schedule settings, frequency, or target.

To edit: Click ••• → Edit Schedule

You can change the schedule name, description, frequency, timing, days, timezone, or target entity. Click Save to apply changes.

Note: Changing the frequency or timezone recalculates the next run time immediately.

Run Now​

Manually trigger the schedule outside of its normal timing.

To run: Click ••• → Run Now

The schedule executes immediately and creates an activity. This does NOT affect the schedule's next run time.

Enable/Disable Schedule​

Toggle automatic execution on or off without deleting the schedule.

To disable: Click ••• → Disable Schedule

  • Schedule stops running automatically
  • State changes to "Inactive"
  • Next run shows "Inactive"
  • Run Now becomes disabled

To enable: Click ••• → Enable Schedule

  • Schedule resumes automatic execution
  • State changes to "Active"
  • Next run time recalculated

Delete Schedule​

Permanently remove the schedule.

To delete: Click ••• → Delete Schedule

⚠️ Warning:

  • Deletion is permanent and cannot be undone
  • Schedule removed from list
  • Historical execution data remains for audit purposes

Viewing Execution History​

To view: Click ••• → View Details on any schedule

The detail modal shows:

  • Schedule configuration (cron expression, timezone, created/updated dates)
  • Target entity information
  • Last 20 executions with status, duration, and error messages (if any)

To monitor activities: Navigate to Activities in the sidebar to view detailed execution logs for each scheduled run.

Troubleshooting​

Schedule Not Executing​

Problem: Schedule shows as active but doesn't run at expected time.

Solution:

  • Check next run time in schedules list
  • Verify timezone is correct (times shown in selected timezone)
  • Ensure target pipeline/task/orchestration is active
  • View execution history for silent failures
  • Try toggling schedule off and back on

Execution Fails​

Problem: Schedule runs but execution fails.

Solution:

  1. Click ••• → View Details
  2. Expand Execution History
  3. Read error message for failure reason
  4. Common causes:
    • Target entity deleted
    • Source/destination credentials expired
    • Invalid pipeline/task configuration
  5. Fix the underlying issue and test manually before next scheduled run

Next Run Time Incorrect​

Problem: Next run time doesn't match expected schedule.

Solution:

  • Verify timezone in detail modal (times shown in selected timezone)
  • Review actual cron expression - visual builder may interpret differently
  • Note: Daylight Saving Time shifts schedules by 1 hour
  • Edit and save schedule to force recalculation

Can't Use Advanced Frequencies​

Problem: Minute, hourly, and custom cron frequencies show "PRO" badge and are disabled.

Solution:

  • These frequencies require PRO or Enterprise plan
  • Free users can use daily, weekly, or monthly schedules

Support​

Need help? Contact us at support@supa-flow.io

Last updated on by pungaa
AI Tools
Ask ChatGPTClaudeAsk Claude
On this page