Schedules
Learn how to automate your data syncs with scheduled sync runs in Codeless Sync.
Schedules
A schedule automates your sync runs at specified intervals. Instead of manually triggering syncs, schedules run them automatically based on your chosen frequency.
Schedules are a Premium feature. Free plan users can trigger manual syncs anytime, but automated scheduling requires a Premium subscription.
Schedule Components
Each schedule includes:
- Configuration - Which sync configuration to run
- Frequency - How often to run (hourly to monthly)
- Sync Mode - Full sync or incremental (1 day, 7 days, 30 days)
- Status - Active or paused
- Pause Reason - Why the schedule is paused (if applicable)
Creating a Schedule
- Go to Configurations in your dashboard
- Find the configuration you want to schedule
- Click Create Schedule (or the schedule icon)
- Select your desired frequency
- Choose the sync mode (full or incremental)
- Click Create Schedule
Use incremental syncs for hourly schedules to reduce API calls and processing time. Use full syncs for daily or weekly schedules to ensure complete data accuracy.
Schedule Frequencies
Available frequencies for Premium plans:
| Frequency | Interval | Best For |
|---|---|---|
| Hourly | Every hour | Standard syncing (coming soon) |
| Daily | Once per day | Daily reporting |
| Weekly | Once per week | Weekly summaries |
| Monthly | Once per month | Monthly snapshots |
Schedule Status
Schedules have an active status that can be toggled:
- Active - Schedule runs automatically at the specified frequency
- Inactive - Schedule is paused, no automatic syncs occur
You can manually toggle a schedule's status at any time without deleting it.
Schedule Pauses
Schedules can be paused automatically by the system for various reasons. Understanding these pause reasons helps you quickly resolve issues and get your syncs running again.
Auto-Recovery Pauses
These pauses are temporary and resolve automatically when your limits reset:
| Pause Reason | Description | Recovery |
|---|---|---|
| Daily sync limit exceeded | You've reached your plan's daily sync quota | Auto-resumes when daily limits reset |
| Monthly row limit exceeded | You've processed the maximum rows for your billing period | Auto-resumes when monthly limits reset |
You don't need to take any action for auto-recovery pauses. Your schedule will automatically resume when the limits reset. Consider upgrading your plan if you frequently hit these limits.
Manual Resolution Required
These pauses require you to fix the underlying issue and reactivate the schedule:
| Pause Reason | Description | How to Resolve |
|---|---|---|
| Runtime errors | Too many consecutive sync failures occurred | Check sync history for error details, fix the underlying issue (API errors, network issues, etc.), then reactivate the schedule |
| Bad credentials | Provider API key is invalid, expired, or revoked | Update your API key in the configuration settings, then reactivate the schedule |
| Schema mismatch | Database table structure was modified and no longer matches expected schema | Restore the original table schema or recreate the table using the SQL template, then reactivate the schedule |
| Config inactive | The associated configuration was deactivated | Reactivate the configuration first, then reactivate the schedule |
| Project inactive | The associated database project was deactivated | Reactivate the project first, then reactivate the schedule |
Avoid schema mismatch errors: Do not modify your synced table's schema (column names, types, or constraints) after creation. If you need to change the structure, delete the configuration and create a new one with a fresh table.
When a schedule is paused for manual resolution, it will not automatically resume. You must fix the issue and manually reactivate the schedule from your dashboard.
Reactivating a Paused Schedule
- Go to Schedules in your dashboard
- Find the paused schedule (shows pause reason)
- Resolve the underlying issue if applicable
- Click Reactivate or toggle the status to Active
Managing Schedules
Edit a Schedule
You can update:
- Frequency
- Sync mode (full/incremental)
- Active status
You cannot change:
- The associated configuration
- (Delete and recreate instead)
Delete a Schedule
Deleting a schedule:
- ✅ Stops all automatic syncs for that configuration
- ✅ Removes the schedule from your dashboard
- ❌ Does NOT delete the configuration
- ❌ Does NOT delete synced data
Best Practices
Choose Appropriate Frequencies
- Hourly syncs - Use incremental syncs to minimize API usage
- Daily/Weekly syncs - Balance between freshness and efficiency
- Monthly syncs - Full syncs ensure complete data accuracy
Monitor Your Usage
- Check your usage dashboard regularly
- Watch for schedules approaching quota limits
- Upgrade your plan before hitting limits to avoid pauses
Handle Pauses Promptly
- Set up notifications for schedule pauses (coming soon)
- Check pause reasons in your dashboard
- Resolve issues quickly to minimize data gaps
Environment Considerations
- Use less frequent schedules for development/staging
- Reserve high-frequency schedules for production
- Test schedule configurations in test mode first
Next Steps
- Configurations - Set up configs to schedule
- Quick Start - Create your first sync
- Troubleshooting - Resolve common issues