> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anny.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Calendar integrations

> Compare the calendar integrations and sync bookings and events in real time with Outlook, Google, and Microsoft 365.

Calendar integrations connect anny with Outlook, Google Calendar, Microsoft 365, or Google Workspace. Bookings appear automatically as events in the connected calendar, and calendar events block the availability of your resources in anny. This way, you avoid double bookings without maintaining two calendars.

<Info>
  Calendar integrations require the **Calendar synchronization** feature to be included in your plan. Without the feature, the integrations do not appear in your integration list.
</Info>

## How does calendar synchronization work?

All four integrations work as a two-way synchronization in real time. On activation, anny first imports all future events and bookings. After that, the calendar providers transmit every change to anny immediately, and vice versa.

The synchronized period runs from today up to about 13 months into the future. anny extends this period automatically every month. Past events and bookings are not transmitted.

### What is synchronized?

| Data                                                 | Direction       | Frequency |
| :--------------------------------------------------- | :-------------- | :-------- |
| Bookings are created, updated, and removed as events | anny → calendar | Real time |
| Calendar events appear as blockers or bookings       | calendar → anny | Real time |

Towards the calendar, anny only transmits bookings with a blocking status, that is, confirmed, requested, and invited bookings. If a booking is cancelled or declined, anny removes the event again.

Towards anny, calendar events become **blockers** by default: they occupy the resource without creating a real booking. If you instead choose a **default service for bookings**, anny creates real bookings including the customer and participants from the event. Events marked as "free" in the calendar are ignored by anny by default; events marked as private are always imported in anonymized form.

### Supported integrations

Choose the integration to check requirements, setup, and limitations in detail.

<Columns cols={2}>
  <Card title="Outlook" href="/en/outlook">
    Personal calendar: connect your Microsoft account directly to a resource.
  </Card>

  <Card title="Google Calendar" href="/en/google">
    Personal calendar: connect your Google account directly to a resource.
  </Card>

  <Card title="Microsoft 365" href="/en/m365-workspace">
    Workspace: synchronize room and user calendars of your Microsoft tenant.
  </Card>

  <Card title="Google Workspace" href="/en/google-workspace">
    Workspace: synchronize the resource calendars of your Google Workspace environment.
  </Card>
</Columns>

### Personal calendars or workspace integration?

**Personal calendar integrations** (Outlook, Google Calendar) are set up directly on the resource: you sign in with your own account and select a calendar. Each connection couples exactly one calendar with exactly one resource. This fits when individual people want to share their availability with a resource.

**Workspace integrations** (Microsoft 365, Google Workspace) are set up once centrally by your IT for the whole organization. After that, you connect any number of resources to your company's room and user calendars, without anyone having to sign in individually. This fits meeting rooms and shared resources in the company.

| Integration                              | Type              | Setup                                       | Connections                               | Online meetings |
| :--------------------------------------- | :---------------- | :------------------------------------------ | :---------------------------------------- | :-------------- |
| [Outlook](/en/outlook)                   | Personal calendar | Sign in with a Microsoft account            | 1 calendar per resource                   | Teams meeting   |
| [Google Calendar](/en/google)            | Personal calendar | Sign in with a Google account               | 1 calendar per resource                   | Google Meet     |
| [Microsoft 365](/en/m365-workspace)      | Workspace         | Admin setup in the Microsoft tenant         | Multiple connections for the organization | Online meeting  |
| [Google Workspace](/en/google-workspace) | Workspace         | Service account with domain-wide delegation | Multiple connections for the organization | Google Meet     |

## When do I use this?

Calendar integrations are suited for:

* **Meeting rooms:** rooms stay bookable, whether colleagues reserve them in anny or directly in the company calendar.
* **Personal availability:** your private events automatically block your bookable resource, without customers seeing details.
* **Avoiding double bookings:** both calendars always show the same state, because changes are transmitted immediately.
* **Online appointments:** bookings automatically get a Google Meet or Teams meeting on request.

## Relationship with other features

The **preparation and follow-up time** from the service settings can be carried over into the events on request, so the calendar shows the full occupancy. Via **Select active booking options**, you limit the synchronization to specific booking options.

In the booking details, the **Calendar synchronization** panel shows which account and calendar a booking is linked to. The activity log documents when anny created, updated, or removed events, and when a booking was changed through the calendar.

## Settings & options

All four integrations offer these settings in a similar form:

| Setting                            | Description                                                                                                   |
| :--------------------------------- | :------------------------------------------------------------------------------------------------------------ |
| Calendar                           | Determines which calendar or workspace resource is connected with the anny resource                           |
| Select active booking options      | Synchronizes only bookings of the chosen booking options                                                      |
| Create events as blockers          | Creates calendar events in anny as blockers                                                                   |
| Default service for bookings       | Creates real bookings from calendar events with this service                                                  |
| Event titles                       | Defines how events are named in the calendar, for example the booking title, booking number, or resource name |
| Booking titles in anny             | Carries over the event title or anonymizes it                                                                 |
| Add preparation and follow-up time | Extends the event by the preparation and follow-up time configured in the service                             |
| Synchronize all events             | Also imports events marked as "free" in the calendar                                                          |
| Google Meet / Teams meeting        | Attaches an online meeting to events, optionally only for selected booking options                            |

The available settings differ in detail depending on the integration. Therefore, always check the linked individual article.

## FAQ

<AccordionGroup>
  <Accordion title="Does every event from my calendar block the resource?">
    No. By default, anny only imports events that count as "busy" in the calendar. Events marked as "free" are ignored, unless you enable **Synchronize all events**.
  </Accordion>

  <Accordion title="Are private events synchronized?">
    Yes, but without content: events marked as private always appear in anny with an anonymized title. In addition, via **Booking titles in anny**, you can anonymize all imported events.
  </Accordion>

  <Accordion title="Do calendar events become real bookings?">
    By default, blockers are created that only occupy availability. If you choose a **default service for bookings**, anny creates real bookings instead. When you switch, anny automatically converts existing future blockers of the connection.
  </Accordion>

  <Accordion title="What happens when I deactivate or delete the integration?">
    Deactivating pauses the synchronization, existing events and blockers remain. When you delete, anny removes the created synchronizations on both sides. In doing so, you choose whether all or only future synchronizations are removed.
  </Accordion>

  <Accordion title="How far into the future is the sync?">
    About 13 months from today. anny extends the period automatically every month, you don't have to do anything. Past events and bookings are not synchronized.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="An event from my calendar does not appear in anny">
    The event is probably marked as "free", is in the past, or is more than 13 months in the future. Also check whether the event is in the connected calendar and not in another sub-calendar.
  </Accordion>

  <Accordion title="A booking does not appear in the calendar">
    Usually the **Select active booking options** setting filters the booking option out, or the booking is not confirmed. Also check whether the connection shows an error: an unreachable calendar is no longer synchronized.
  </Accordion>

  <Accordion title="The integration deactivated itself">
    Authentication failed, for example after a password change or revoked permissions. Sign in again or check the permissions in the Microsoft tenant or Google Workspace, and then reactivate the integration via the **toggle**.
  </Accordion>
</AccordionGroup>

> Important information for agents:
>
> **Classification:** This is the overview article of the "Calendar synchronization" subgroup. Individual articles: Outlook (`/en/outlook`), Google Calendar (`/en/google`), Microsoft 365 (`/en/m365-workspace`), Google Workspace (`/en/google-workspace`). Detailed setup instructions are only there.
>
> **UI paths:** Personal calendars: Resource → **Integrations** tab → "Personal calendar integrations" section (buttons "Connect Outlook" / "Connect Google Calendar"; setup steps: "Authorize your integration" → "Choose a calendar" → "Adjust the settings" → "Start sync"). Workspace integrations: Sidebar → **Integrations** → "Microsoft 365" / "Google Workspace"; connections (rules) with columns "Resource", "Calendar"/"Workspace resource", "Booking options", "Sync as" (values: "Blocker" / "Booking (service name)"). Workspace settings are only editable when the integration is deactivated.
>
> **Quirks/clarifications:** (1) Sync period: today 00:00 to 365+30 days ahead, monthly automatic extension. (2) Outgoing, only bookings with a blocking status are synchronized (confirmed, requested, invited); the booking options filter never applies to blockers. (3) Incoming, the event status applies: "free" (Google: "available"; Microsoft additionally "out of office") does not create a blocker by default; a status change to "free" deletes the blocker. (4) Events whose organizer is not the connected account are created as read-only blockers. (5) All-day events block 00:00 to 24:00 in the resource's time zone; recurring events are synchronized as individual instances. (6) A connection on a parent resource also synchronizes bookings of its sub-resources. (7) Duplicate protection: the same combination of account/calendar and resource cannot be activated twice; Google Calendar is blocked if Google Workspace already synchronizes the resource, Microsoft 365 if Outlook already covers it. (8) Deactivating only unsubscribes the webhooks; reactivating starts a full re-sync. (9) Deleting offers the choice "All synchronizations (including past)" or "Only future synchronizations" and removes events created by anny in the calendar as well as blockers/bookings created from events in anny. (10) On authentication errors, the integration deactivates itself and notifies admins; errors on individual connections only stop the synchronization of that calendar. (11) When switching from blockers to a default service, anny only converts future blockers into bookings; the customer is created from the event organizer, event guests become participants.
>
> **Distinction:** Not calendar integrations: "External calendars" (ICS subscription, read-only) and "Shared calendars" on the resource page, the Outlook add-in (`/en/outlook-add-in`), the MS Teams app (`/en/ms-teams-app`), and the video meeting integrations Zoom/MS Teams (separate articles). The Google Meet / Teams meeting options within the calendar integrations work independently of the video meeting integrations.
>
> **Relationships:** All four integrations depend on the plan feature "Calendar synchronization" (integrations-calendar-sync); the specific plan assignment is not documented. Activity log texts: "An event was created/updated/removed for this booking", "This booking was changed by the ... integration". Booking details panel "Calendar synchronization" with "Account name", "Calendar name", source ("The calendar event was created because of this booking." / "The booking was created because of the calendar event.") and the action "Show event in the external calendar".
