Who This Is For / When to Use
Use this guide if you rely on Apple iCloud Calendar and want Kyrios to check availability, sync events, and manage bookings across supported calendar types.
Supported Calendars and Limitations
Supported Kyrios Calendars
Class Booking Calendars
Round-Robin Calendars
Collective Calendars
Service Calendars
Not Supported
Simple Calendars
Subscription/Public iCloud Calendars added via URL
Step 1: Generate an App-Specific Password from Apple
Kyrios requires an app-specific password to connect to iCloud.
Go to appleid.apple.com and sign in.
Open Sign-In and Security.
Select App-Specific Passwords.
Click Generate an app-specific password.
Enter a label such as CRM Calendar, then click Create.
Copy the generated password and store it securely.
This password is shown once and cannot be recovered later.
Step 2: Connect iCloud Calendar in Kyrios
Log in to your Kyrios account.
Go to Settings → My Profile → Calendar Settings.
Locate iCloud Calendar and click Connect.
Enter:
Your iCloud Apple ID (email or phone number)
The App-Specific Password generated earlier
Click Connect.
The status updates to Connected when successful.
Step 3: Configure the Primary Calendar
After connecting iCloud:
In My Profile, locate Primary Calendar.
Click Edit.
Select the iCloud calendar to use for read/write syncing.
Click Save.
You can also choose Do not sync new events to the primary calendar if you only want availability checking.
Step 4: Configure Linked and Conflict Calendars
Linked Calendar
All new events created in Kyrios sync to the selected iCloud calendar.
Writer access is required.
By default, the linked calendar is also added as a conflict calendar.
Conflict Calendars
Additional iCloud calendars can be checked to prevent double bookings.
Events marked BUSY block availability.
Events marked FREE do not block availability.
Sync Behavior and Limitations
Two-way sync is supported:
Events created in Kyrios sync to iCloud.
Events created in iCloud sync to Kyrios.
Event deletions in iCloud do not delete events in Kyrios.
Blocked slots created in Kyrios do not sync back to iCloud.
iCloud events do not create contacts in Kyrios; they appear only as blocked time.
Common Issues and Fixes
Connection Fails During Setup
Verify two-factor authentication is enabled on your Apple ID.
Confirm the app-specific password was copied correctly.
Generate a new app-specific password if needed.
Availability Not Blocking
Ensure the iCloud event is marked BUSY, not FREE.
Confirm the calendar is added as a conflict calendar.
FAQ
How do I get an app-specific password for iCloud integration?
Sign in at appleid.apple.com, go to Sign-In and Security → App-Specific Passwords, generate a new password, and use it during Kyrios setup.
Which Kyrios calendars support iCloud integration?
Class booking, round-robin, collective, and service calendars. Simple Calendars are not supported.
What happens if I delete an event in iCloud?
Deleting an event in iCloud does not delete it in Kyrios.
Can iCloud events create contacts in Kyrios?
No. iCloud events are treated as blocked slots only.
Do blocked slots from Kyrios sync to iCloud?
No. Blocked slots created in Kyrios do not sync back to iCloud.
Can I sync public or subscription iCloud calendars?
No. Calendars added via URL are not supported.
Will every iCloud event block my availability?
Only events marked BUSY block availability. FREE events do not.