> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.zoyya.me/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://help.zoyya.com/en/article/en-how-to-connect-a-google-calendar-to-zoyya-desktop-ogkliv/) · [Mobile](https://help.zoyya.com/en/article/en-how-to-connect-a-google-calendar-to-zoyya-mobile-164lrks/)

## 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

1. Open [Google Calendar](https://calendar.google.com/) and sign in with the Google account you use to manage the calendar you want to connect.
2. Click the gear icon in the top-right corner, then **Settings**.
3. In the left menu, under **Settings for my calendars**, select the calendar you want to connect.
4. Open **Integrate calendar**.
5. 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

1. Open **Settings > Employees and resources > Employees** in the Zoyya partner web app.
2. Select the employee whose Google Calendar you want to connect.
3. Open the **Calendar sync** tab and click **Add import source**.
4. In **Name**, enter a recognizable name, for example **Google – Ana**.
5. Select **Google Calendar** under **Provider**.
6. In **ICS URL**, paste the secret iCal link you copied from Google Calendar.
7. If you wish, select a **Color** and make sure **Enabled** is on.
8. Click **Preview** to check whether Zoyya recognizes the events from the selected Google calendar. Preview does not import appointments yet.
9. Close the preview and click **Add**.
10. Click **Sync now** on the saved source to start importing.
11. 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

1. On the **Calendar sync** tab, Find the Google Calendar source and click **Delete**.
2. Choose **Keep future imported appointments** or **Cancel future imported appointments**, depending on whether you want to keep future appointments that have already been imported.
3. 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.

## Related

- [How to use the calendar (desktop)](https://help.zoyya.com/en/article/how-to-use-the-calendar-desktop-1lrrh8k/)
- [Google's instructions for finding the secret iCal link](https://support.google.com/calendar/answer/37648)