How to connect an Apple iCloud calendar to Zoyya (mobile)

This article explains how to connect an Apple iCloud calendar to an employee in Zoyya using the Zoyya partner web app on mobile. Events from the iCloud calendar are imported into Zoyya and block the selected employee’s time.

PLATFORM_SWITCH: Desktop · Mobile

Before you start

To connect the calendar, you need a subscription link to a publicly shared iCloud calendar. The calendar must be stored in iCloud; local calendars and calendars belonging to other accounts in Apple’s Calendar app are not automatically iCloud calendars.

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.

Find the link to your iCloud calendar

1. On your iPhone, open Apple’s Calendar app.
2. Tap Calendars, then the Info button next to the iCloud calendar you want to connect.
3. Enable Public Calendar.
4. Tap Share Link and copy the calendar link.

On Android, you cannot obtain this link from Apple’s iPhone Calendar app. Get the link on an iPhone, iPad, or computer, then finish connecting it in Zoyya using a web browser on your Android phone.

Connect the calendar to Zoyya

1. Open the Main menu in the Zoyya partner web app on mobile.
2. Under Business, tap Settings.
3. Open Employees and resources > Employees.
4. Select the employee whose Apple iCloud calendar you want to connect.
5. Open the Calendar sync tab and tap Add import source.
6. In Name, enter a recognizable name, for example Apple iCloud – Ana.
7. Select Apple iCloud under Provider.
8. Paste the prepared ICS/iCal link into ICS URL.
9. If you wish, select a Color and make sure Enabled is on.
10. Tap Preview to check whether Zoyya recognizes the expected events. Preview does not import appointments.
11. Close the preview and tap Add.
12. Tap Sync now on the saved source to start importing immediately.
13. Check Last successful sync and the number of Processed events, then check the employee’s calendar.

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

How syncing works

This source syncs in one direction: Apple iCloud → Zoyya. Events from the published iCloud calendar are transferred to Zoyya as busy time for the selected employee. Make changes in the iCloud calendar. Zoyya does not change the original iCloud calendar through this connection; the separate ICS export option is not the same as two-way editing.

If several employees use separate calendars, repeat the procedure on each employee’s profile and use their corresponding link.

Check or update the connected calendar

On the Calendar sync tab, you can tap Sync now to import manually or Edit to change the source settings. If you are the calendar owner, you can open Preview for a saved source and check the events. Other authorized users can check the dates of the last sync attempt and last successful sync.

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

Remove the connected source

1. On the Calendar sync tab, Find the relevant source and tap 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 tapping Delete source. Past appointments are not changed.

If syncing does not work

Check that the selected calendar is actually an iCloud calendar and that Public Calendar is enabled. An iCloud link may begin with webcal://; Zoyya converts it to a secure HTTPS address when it is entered. If you receive an error saying the provider is not allowed, contact Zoyya Support with the domain name, without sending the full link.

Check that Apple iCloud is selected as the provider, that the source is marked Active, and that the last sync was successful. If the issue persists, provide Zoyya Support with the branch, employee, source name, displayed status, and time of the last attempt. Do not send the full private ICS link.

Related

• How to use the calendar (mobile)
• Apple's instructions for publicly sharing an iCloud calendar

Updated on: 19/10/2026