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
.