Scheduled Triggers
Scheduled Triggers let you run workflows on a recurring basis by polling an API at regular intervals. They're perfect for apps that don't support webhooks or where real-time events aren’t available.
How It Works
viaSocket calls your configured API endpoint every few minutes
If new or updated data is found, it starts the workflow
This happens per active workflow, automatically
🔄 The polling frequency depends on the user’s pricing plan—typically every 5 to 15 minutes
Use Cases
Check for new rows in a Google Sheet or Airtable
Pull updated leads from your CRM every 10 mins
Sync newly created records from any API-based app
Smart Filtering with __executionStartTime__
viaSocket gives you a built-in variable called __executionStartTime__
—this represents the exact timestamp when the scheduled trigger runs.
You can use it to fetch only new data since the last run.
Example: Get Records X Minutes Ago
Use this logic in your API request logic to filter results:
const minutesAgo = new Date(__executionStartTime__ - context?.inputData?.scheduledTime * 60 * 1000);
__executionStartTime__
→ the current run’s timestampcontext?.inputData?.scheduledTime
→ user-defined interval (e.g., 10 minutes)minutesAgo
→ gives the timestamp for “X minutes ago”
Now you can query your API for records created after minutesAgo
.