Manage Your Syncs

All your syncs live in the Synchronizations table on the Calendar Sync dashboard. Each sync runs automatically in real time, but you can manage it at any moment from the three dots menu at the end of its row.

The menu offers the following actions:

• View Details: Opens a summary of the sync, including its calendars, all the configuration settings, the last detected change and the current status.
• Re-run Sync: Queues a full sync run immediately.
• Edit: Opens the sync editor, where you can change the sync name and all the sync configuration settings.
• Edit Calendars: Lets you change which calendars the sync uses, without touching the rest of the configuration.
• Pause or Un-Pause: Temporarily stops or resumes the sync.
• Delete: Deletes the sync and all the clone events it created. See How to delete a sync.

Pause a sync

Pausing stops OneCal from syncing new changes to the target calendars until you un-pause the sync. When you click Pause, a confirmation dialog appears.

By default, the clone events that the sync has already created stay in your calendars. If you also want them removed while the sync is paused, check Also delete clone events created by this sync before confirming. The clones are then removed in the background, and the sync shows a temporary status while this happens.

While a sync is paused, the Re-run Sync, Edit and Edit Calendars actions are hidden. Un-pause the sync first to use them.

Un-pause a sync

To resume a paused sync, open the three dots menu and click Un-Pause. OneCal immediately queues a full run of the sync, so any clone events that were deleted or any changes that happened while the sync was paused are brought back up to date automatically.

Syncs can pause themselves

Your sync may automatically enter a paused state if one or more of its connected calendars require manual re-authentication. This is a security requirement from Google and Microsoft to confirm that you are actively using the services you have authorized, and it typically only needs to be done once every few months per account. It can also happen if you recently changed your password, if your organization requested it, or if Google or Outlook is having a temporary outage.

When this happens, OneCal notifies you via email that a manual action is required, and cannot access the affected calendars until you re-authenticate them. Refresh the affected connections as described in Fix an Expired Calendar Connection, then un-pause the sync from the three dots menu.

Re-run a sync

If you ever think a sync missed something, click Re-run Sync. This queues a full run that goes through all the events in the source calendars again and updates the clones accordingly. There is no confirmation step, the run starts right away and the status changes to In Queue.

Sync statuses

The Status column of the table shows what each sync is currently doing:

• In Queue: A run is queued and will start shortly.
• In Progress: The sync is currently running.
• Success: The last run completed successfully.
• Error: The last run failed. Try re-running the sync, and if the problem persists, please contact our support team.
• Paused: The sync is paused and will not process changes until you un-pause it. Syncs are also shown as paused while your subscription is expired.

When you pause a sync with clone deletion, or delete a sync, you may briefly see transitional statuses such as Pausing or Deleting while OneCal removes the clone events in the background.

The Last Detected Change column shows the last time OneCal detected a change on the calendars of that sync. Since syncs are real-time, this updates automatically as changes happen.