This article is also available in:

How to connect a Google calendar to Zoyya (desktop)

This article explains how to connect a Google calendar to an employee’s calendar in Zoyya using the Zoyya partner web app on desktop. Events from Google Calendar are imported into Zoyya and block the selected employee’s time to help reduce double bookings.

PLATFORM_SWITCH: Desktop · Mobile

Before you start

To connect the calendar, you need access to the Google calendar you want to connect and its Secret address in iCal format. This link allows Zoyya to read events from that calendar.

The employee must already be saved in Zoyya, and you need permission to edit employees and resources to access the Calendar sync tab. The feature must be enabled for your branch.

Important: The secret iCal link provides access to your Google Calendar data. Do not publish it, share it with other people, or include it in screenshots. Enter it directly in Zoyya to connect the calendar.

Find the iCal link in Google Calendar

Open Google Calendar and sign in with the Google account you use to manage the calendar you want to connect.
Click the gear icon in the top-right corner, then Settings.
In the left menu, under Settings for my calendars, select the calendar you want to connect.
Open Integrate calendar.
Find Secret address in iCal format and copy the entire link.

Do not copy Public address in iCal format. Use the secret address to connect a private Google calendar.

Connect Google Calendar to Zoyya

Open Settings > Employees and resources > Employees in the Zoyya partner web app.
Select the employee whose Google Calendar you want to connect.
Open the Calendar sync tab and click Add import source.
In Name, enter a recognizable name, for example Google – Ana.
Select Google Calendar under Provider.
In ICS URL, paste the secret iCal link you copied from Google Calendar.
If you wish, select a Color and make sure Enabled is on.
Click Preview to check whether Zoyya recognizes the events from the selected Google calendar. Preview does not import appointments yet.
Close the preview and click Add.
Click Sync now on the saved source to start importing.
Check Last successful sync and the number of Processed events, then check the Zoyya calendar to make sure the employee’s time is correctly blocked.

After connecting the calendar, Zoyya continues to check Google Calendar periodically. You do not need to start every sync manually.

How syncing works

This source syncs in one direction: Google Calendar → Zoyya. Google Calendar events are imported into Zoyya as busy time for the selected employee. Make changes or cancel Google events in Google Calendar; Zoyya picks them up during the next sync.

Appointments created in Zoyya are not added to Google Calendar through this connection. The separate ICS export option lets you subscribe to a Zoyya calendar in an external calendar app, if it is enabled for your branch. It does not turn this connection into two-way appointment editing.

If each employee has their own Google calendar, repeat these steps for each employee using the corresponding iCal link.

Check or update the connected calendar

On the Calendar sync tab, you can click Sync now to import manually or Edit to change the source settings. Preview of a saved source is available to the calendar owner; other authorized users can check the last sync attempt and the last successful sync.

The secret iCal link is no longer displayed after it is saved. If it changes, click Edit, paste the new link into New ICS URL (leave empty to keep saved URL), and click Save.

Remove the connected Google calendar

On the Calendar sync tab, Find the Google Calendar source and click Delete.
Choose Keep future imported appointments or Cancel future imported appointments, depending on whether you want to keep future appointments that have already been imported.
Confirm by selecting Delete source. Past appointments are not changed.

If syncing does not work

Check that you selected Google Calendar as the provider, pasted the Secret address in iCal format rather than the public address, and that the source is marked Active. Then check the source status and the time of the last sync attempt. If you are the calendar owner, you can also open Preview for the saved source.

If you cannot see Secret address in iCal format in Google Calendar, your Google Workspace account settings may restrict access to that link. Contact your Google account administrator. If you cannot see the Calendar sync tab in Zoyya, contact Zoyya Support to check your access and whether the feature is available.

Updated on: 19/10/2026

Was this article helpful?

Thank you!