How to Connect Your iCloud Calendar

Prerequisites

1. You need access to your apple account associated with the iCloud Calendar you want to connect.

2. You need to obtain your unique app-specific password from Apple.

3. Check if writer's access is required:

   • If you want to add events created in the system to your iCloud Calendar, writer's access is necessary for the calendar.

   • If you simply want to fetch all your events from your iCloud Calendar to the system, read-only access will suffice.

Getting Started

Step 1: Obtain your unique app-specific password from Apple

Obtain your app-specific password from Apple before connecting your iCloud calendar. The password for this account is different from the password for your regular Apple account. When connecting to third-party apps, Apple mandates the use of an app-specific password in addition to two-factor authentication.

To obtain your app-specific password, follow these steps:

1. Sign in to https://appleid.apple.com/

2. Enable two-factor authentication under the Security section if you haven't already done so.

3. In the App-Specific Passwords section, choose "Generate Password."

4. Enter a label for the password (for instance, "CRM iCloud Integration") and click "Create."

5. Copy and safely keep the generated app-specific password. This will be used when connecting your iCloud calendar in the next step.

Step 2: How to Connect iCloud Calendar?

To connect to iCloud Calendar, follow these steps:

1. Navigate to "Calendars" > "Calendar Settings" > "Connections."

2. Click on "Add New."

3. Choose 'iCloud Calendar' and click 'Connect.'

4. Enter your Apple ID and the app-specific password generated earlier.

5. Click "Connect".

Step 3: Calendar Configuration

Once your iCloud Calendar is successfully connected, you need to complete your calendar configuration by selecting your linked calendar and conflict calendar.

Please Note:

Writer's access is required for the user to select a calendar as a linked calendar. 

The linked calendar is by default added to the conflict calendar. This means any event created on the third-party linked calendar will be fetched in the system, and any event created in the system will be pushed to the third-party linked calendar.

Conflict Calendar:

Events from third-party calendars added as conflict calendars are synced to the system, blocking your availability for the event's duration. 

The availability is blocked only if the event is marked as "BUSY" in the third party calendar. For events marked as "FREE", the events are fetched in the system but the availability remains open. 

This ensures accurate availability and avoids double bookings. You can add multiple calendars to be checked to prevent double bookings. 

Limitations with iCloud Integration

• While Google and Outlook Connections offer an option to configure their Sync Preferences from the Advanced Settings, iCloud only supports Default Sync (One-Way Sync).

• This means that all events coming in from iCloud would be treated as Blocked Slots, and no contacts would be created for the guests found in these events.

• Another limitation is that if a Blocked Slot is created in the system for a user, it would not sync to the iCloud Calendar.

• Integration with a subscription calendar is not possible. This means that Topline OS cannot connect to iCloud calendars that you have subscribed to via URL (usually public calendars).