Integrate Your Calendar

With the calendar integration, you can display your appointments in Times, Calendar, and Planner in awork. Your appointments are also included in the Workload calculation, or you can automatically sync tasks from awork into your calendar.

Your appointments are not stored in awork and visibility can be configured in the settings.

---

Which calendar providers does awork support?

awork supports the following calendar services:

• Google Workspace
• Microsoft (Outlook & Exchange)
• Apple iCloud

You can connect as many of your own calendars as you like - from the same or different providers.

---

Link Your Calendar

Google & Microsoft

1. Start the integration in awork via:

• the Calendar icon in Times, Calendar, or Planner
• or the Integration library under Settings > Integrations.

2. You'll be redirected to the provider's login page.
3. Sign in and allow awork to access your account.
4. In awork, select which calendar groups should be displayed.

Your appointments now appear in awork. You can identify each provider by the icons used.

Apple iCloud

1. Enter your Apple ID in the awork popup.
2. Go to appleid.apple.com and follow the instructions in the awork popup.
3. Navigate to Security > App-specific passwords and generate an app password.
4. Confirm in awork that you've completed the steps.
5. Enter the password in awork.

Your appointments now appear in awork. You can identify each provider by the icons used.

---

Calendar Settings

You can edit the settings in the same place where you started the integration.

Select Calendars

Choose which calendars should be displayed.

Visibility for Other Users

• Use the Share calendar & use for Workload button to decide whether your calendar events are visible to others in awork.
• Use the Share event names (non-private only) button to determine that event names are visible in the calendar (except for private events).

Load Out-of-Office Appointments

You can load out-of-office appointments from your linked calendar and treat them as absences in awork. To do this, enable or disable the Load "out-of-office" appointments and treat as absence option in the calendar integration settings.

When this setting is enabled:

• out-of-office appointments are displayed in the awork Calendar
• they reduce the available capacity of the user in the Planner's Workload
• the total duration of out-of-office time per day is displayed in the Workload detail popup - similar to calendar entries

This setting is disabled by default and can be enabled per user in the calendar integration settings.

Task Sync (Google & Microsoft only)

• Enable Sync awork tasks with your calendar so they are automatically synced to your external calendar.
• Select the target calendar (e.g., main calendar).
• You can change the target calendar later, and awork will ask you what should happen to the previous appointments in the old calendar: keep all, delete all, or only future appointments.

---

Integrate Calendar for Your Entire Workspace

With Google Workspace and Microsoft Office 365, you can set up a workspace-wide integration.

Workspace-Wide Google Calendar Integration

1. Navigate to Settings (gear icon in the bottom left of the main menu), select Integrations, and open the Integration library.
2. Select the Workspace-wide Google Calendar Integration.
3. Install the awork App in the Google Workspace Marketplace.
4. Select the Domain.
5. Save - the matching with awork users runs automatically: Users in awork and Google are matched based on this domain and the email addresses that users have entered.
6. Now edit the settings for users or disable the integration for individual users.

Workspace-Wide Microsoft Calendar Integration

The awork Microsoft Calendar integration requires a Microsoft 365 Tenant. We authenticate users through Microsoft Entra ID. We read and write data (calendar entries, user mapping, etc.) through the Microsoft Graph.

To set this up, an admin in the awork Workspace must also be an admin in the Microsoft Tenant (Global Administrator, Privileged Role Administrator, Cloud Application Administrator, or Application Administrator).

During authentication, the following scopes are requested and required for ongoing operation: Calendars.ReadWrite, Directory.Read.All, User.Read.All, and Directory.Read.All.

1. Navigate to Settings (gear icon in the bottom left of the main menu), select Integrations, and open the Integration library.
2. Select the Workspace-wide Microsoft Calendar Integration.
3. Install the awork App in your Microsoft 365 account.
4. Select the Domain - the Tenant ID will be pre-filled by the redirect after installation.
5. Save - the matching with awork users runs automatically: The email domain of users in the awork Workspace must match the Microsoft 365 Tenant domain.
6. Now edit the settings for users or disable the integration for individual users.

---

How Do Appointments Affect Workload Calculation in Planner?

• Busy is taken into account for Workload
• Available is not taken into account for Workload
• Focus time is not taken into account for Workload (shown with hatching)
• All-day absence / Out-of-office appointments: choose whether these should be taken into account for Workload

---

FAQ

Can I change or delete an existing integration?

Yes, via the Calendar icon in Times, you can: edit calendar, delete calendar, add more calendars. The workspace-wide calendar integration can also be changed under Settings > Integrations.

Why can awork read user data in Microsoft Entra ID?

awork can read data in Entra ID and user data to match users based on their email address and ensure that only authorized people can set up the integration. This ensures a secure linking of accounts and prevents unauthorized access.

Why are write permissions necessary for the workspace-wide Microsoft Calendar integration to work?

The calendar integration works bidirectionally. Calendar entries are synced from the external calendar to awork. And depending on the calendar settings, scheduled tasks from awork can also be transferred back to the external calendar.

Our users receive a permission error message after logging in with their Microsoft account. What can I do?

If your users receive an error message after logging in with their Microsoft account when connecting their calendar, they may not have the necessary permissions to connect the calendar. Make sure they're allowed to install apps or can request admin consent.

To do this, go to the Entra Admin Center to Enterprise Applications > Consent and Permissions and make sure that either User consent is enabled or that users are allowed to request admin consent.

If necessary, please contact a Microsoft administrator to set up the permissions correctly.