Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hypha-docs.plinqx.app/llms.txt

Use this file to discover all available pages before exploring further.

Scheduled triggers let you run flows automatically on a recurring schedule. Use cron expressions to define when flows should execute.

​
Overview

Scheduled triggers enable:
  • Automated Execution: Run flows on a schedule without manual intervention
  • Cron Expressions: Flexible scheduling with standard cron syntax
  • Timezone Support: Schedule in any timezone
  • Static Inputs: Provide fixed input values for scheduled runs
  • Reliable Execution: Plinqx handles scheduling and execution

​
How Scheduled Triggers Work

1

Configure Schedule

Add a scheduled trigger to your flow with a cron expression.
2

Publish Flow

Publish your flow to activate the schedule.
3

Automatic Execution

Plinqx executes the flow at the scheduled times.
4

Monitor Runs

View execution history in flow run logs.

​
Configuring Scheduled Triggers

1

Open Flow

Navigate to your flow in the Flow Designer.
2

Configure START Node

Click on the START node and select Schedule trigger type.
3

Set Cron Expression

Enter a cron expression (e.g., 0 9 * * * for daily at 9 AM).
Cron expressions use standard 5-field format: minute hour day month weekday
4

Set Timezone

Select the timezone for your schedule (default: UTC).
5

Configure Inputs

Optionally provide static input values for scheduled runs.
6

Save Flow

Save and publish your flow to activate the schedule.

​
Cron Expression Format

Cron expressions use 5 fields: 
┌───────────── minute (0 - 59)
│ ┌───────────── hour (0 - 23)
│ │ ┌───────────── day of month (1 - 31)
│ │ │ ┌───────────── month (1 - 12)
│ │ │ │ ┌───────────── day of week (0 - 6) (Sunday to Saturday)
│ │ │ │ │
* * * * *

​
Common Examples

ExpressionDescription
0 9 * * *Daily at 9:00 AM
0 0 * * 0Weekly on Sunday at midnight
0 0 1 * *Monthly on the 1st at midnight
*/15 * * * *Every 15 minutes
0 9-17 * * 1-5Every hour from 9 AM to 5 PM, Monday to Friday
0 0 1 1 *Yearly on January 1st at midnight

​
Special Characters

  • * - Matches any value
  • , - List separator (e.g., 1,3,5)
  • - - Range (e.g., 1-5)
  • / - Step values (e.g., */15 for every 15 minutes)
  • ? - No specific value (for day of month or day of week)
Use online cron expression generators to help create complex schedules.

​
Timezone Configuration

Scheduled triggers support any timezone:
  • UTC: Default timezone
  • Local Timezones: Select from timezone list
  • Daylight Saving: Automatically handles DST transitions
Timezone changes (like DST) are handled automatically. Your schedule continues to run at the correct local time.

​
Static Inputs

Provide fixed input values for scheduled runs:
  • JSON Input: Define input values as JSON
  • Consistent Data: Same inputs used for every scheduled run
  • Use Cases: Data exports, reports, cleanup jobs
Example: 
{
  "reportType": "daily",
  "format": "csv",
  "recipients": ["[email protected]"]
}

​
Next Run Time

Plinqx calculates and displays:
  • Next Run: When the flow will execute next
  • Previous Run: Last execution time
  • Run History: All past scheduled executions

​
Managing Scheduled Triggers

​
Viewing Active Schedules

1

Navigate to Flows

Go to Flows and open your flow.
2

View Triggers

See all active scheduled triggers for the flow.

​
Pausing Schedules

Temporarily pause a schedule:
  1. Open the scheduled trigger
  2. Toggle Active OFF
  3. Schedule is paused (can be resumed later)

​
Updating Schedules

Update schedule configuration:
  1. Open the scheduled trigger
  2. Modify cron expression or timezone
  3. Save changes
  4. Next run time recalculates automatically

​
Deleting Schedules

Remove a scheduled trigger:
Deleting a scheduled trigger permanently removes the schedule. This cannot be undone.
  1. Open the scheduled trigger
  2. Click Delete
  3. Confirm deletion

​
Best Practices

Test First

Test flows manually before scheduling

Use Timezones

Set appropriate timezone for your schedule

Avoid Overlap

Ensure schedules don’t overlap unnecessarily

Monitor Execution

Regularly check scheduled run logs

​
Use Cases

​
Daily Reports

Schedule daily data exports or reports: 
Cron: 0 8 * * *
Timezone: America/New_York
Input: { "reportType": "daily" }

​
Hourly Data Sync

Sync data from external systems hourly: 
Cron: 0 * * * *
Timezone: UTC
Input: { "syncType": "full" }

​
Weekly Cleanup

Run cleanup jobs weekly: 
Cron: 0 2 * * 0
Timezone: UTC
Input: { "cleanupType": "logs", "retentionDays": 30 }

​
Troubleshooting

​
Schedule Not Running

If scheduled runs aren’t executing:
  • Verify flow is published
  • Check trigger is active
  • Verify cron expression is valid
  • Check timezone is correct
  • Review flow execution logs for errors

​
Incorrect Execution Time

If flows run at wrong times:
  • Verify timezone setting
  • Check cron expression matches intended schedule
  • Account for daylight saving time changes

​
Next Steps

HTTP Webhooks

Learn about webhook triggers

Flow Designer

Build flows with scheduled triggers