# Connect a Google or Outlook calendar to qutee

> Connect Google Calendar or Microsoft 365 / Outlook, activate the calendars for your agent and set working hours, duration and buffers.

Source: https://docs.qutee.ai/en/integrationen/kalender-verbinden/

Connect your Google or Microsoft calendar so your agent can check free slots and add appointments directly. Then you activate the calendars the agent may use and set when and for how long appointments are booked.

## Before you start

- You are signed in as a **Company Admin**.
- Integrations are included in your plan. Otherwise the app shows a lock and "Upgrade to use integrations" in the account menu.
- You have a Google account (Google Calendar) or a Microsoft account (Microsoft 365 / Outlook) that is allowed to add events to the calendars you want.
- With Microsoft, calendars that colleagues have shared with this account also appear.

## Connect an account

1. Click your name to open the account menu and choose **Integrations**.
2. Open the **Calendars** tab.
3. Click **Add new connection**.
4. Click **Connect** for **Google** or **Microsoft**.
5. For Google, qutee first explains data access, use and sharing. Read the disclosure and click **Continue to Google** to proceed. **Cancel** leaves the connection unchanged.
6. Sign in to Google or Microsoft with the account whose calendars the agent should use, and allow access.
7. You are taken back to qutee and see the message "Connection established." The account appears with its calendars on the **Calendars** tab.

Newly found calendars are **Inactive** at first. That way the agent doesn't accidentally book into holiday, birthday or colleagues' calendars.

> **Caution:** If Google reports "Google Calendar is not enabled for this Google account", open calendar.google.com once with this account or ask your Google Workspace admin to enable Google Calendar. Then connect again.

## Activate and set up calendars

You can only select active calendars later in an **Appointment booking**.

1. On the **Calendars** tab, click **Edit** on the calendar you want.
2. Adjust the settings (overview below).
3. Tick **Active**.
4. Click **Save**. The app reports "Calendar updated successfully." and the calendar shows **Active**.

| Setting | Meaning |
| --- | --- |
| **Name** | The name the calendar has in qutee, including in the selection of an **Appointment booking**. |
| **Timezone** | Time zone for working hours and bookable slots, for example `Europe/Berlin`. |
| Working hours (**Use schedule**) | Start and end per weekday within which appointments may fall. Days without hours can't be booked. |
| **Duration (min.)** | Length of a single bookable appointment in minutes. |
| **Buffer before appointment (min.)** | Time before each appointment in which no other appointment can start. |
| **Buffer after appointment (min.)** | Time after each appointment in which no other appointment can start. |
| **Booking window start (min.)** | Earliest possible appointment in minutes from now. Example: `120` means appointments at the earliest in two hours. |
| **Booking window end (days)** | Latest possible appointment in days from now. |
| **Add buffers to the calendar as separate events** | Off: buffers only count when searching for free slots. On: with every booking, qutee also adds the busy events "Vorbereitung" (preparation) and "Nachbereitung" (follow-up). |
| **Active** | The agent can only use active calendars. |

> **Caution:** Newly connected calendars have working hours of Monday to Friday, 9 am to 5 pm. Adjust them to your hours. If **Use schedule** is off, qutee doesn't restrict the time of day, and the agent can also offer appointments in the evening, at night or on weekends.

Appointments start on a 15-minute grid from the start of your working hours. Busy times in your calendar stay free of bookings, whether they were created in qutee or directly in the calendar.

You can also set a different duration, buffers, booking window and booking hours per **Appointment booking**. See [Let your agent book appointments](https://docs.qutee.ai/en/integrationen/termine-buchen-lassen/).

## Add new calendars

If you created a calendar or had one shared with you after connecting, you can bring it into qutee without signing in again:

1. Open **Integrations** > **Calendars**.
2. Click **Refresh calendars** on the account.

The app reports "Calendar list refreshed. Existing calendar settings were kept." New calendars are added as **Inactive** again.

## Calendars marked "Read only"

If a calendar shows **Read only**, the connected account isn't allowed to add events there. The calendar can therefore not be used for bookings.

To fix it:

1. Ask the person who owns the calendar to give the connected account edit rights.
2. Then click **Refresh calendars** on the account. The **Read only** hint disappears.

## Reconnect an expired connection

Google or Microsoft can end the access, for example after a password change, when access was removed in the account, or because of a security policy set by your IT. The agent then can't book appointments in these calendars until you reconnect.

How to spot it:

- A notice appears at the top of the app: "Calendar connection expired (…): your agent cannot book appointments in this calendar."
- Under **Integrations** > **Calendars**, the account shows the status **Expired** and the reason.

qutee doesn't send an email about this. You only see the notice in the app.

1. Click **Reconnect** in the notice or under **Integrations** > **Calendars**.
2. Sign in with the same account the app names in the notice.
3. Back in qutee, the account shows **Active** again. Your calendar settings and assignments are kept.

If you sign in with a different account, qutee rejects it. If you really want to use another account, create a new connection with **Add new connection** and select the calendars again in your agents' appointment bookings.

Reconnecting Google shows the same disclosure. **Continue to Google** opens the Google sign-in flow.

## Deactivate a connection

If the agent should no longer use the calendars of an account:

1. Open **Integrations** > **Connections**.
2. Click **Deactivate** on the account and confirm.

The account then shows **Revoked**, and the agent no longer books in its calendars. qutee deletes the account's access credentials and revokes the access with Google. To use the account again, tick **Show deactivated**, click **Reconnect** and sign in with the same account.

To switch off individual calendars, set them to not **Active** under **Calendars** > **Edit**.

## Check that it works

- Under **Integrations** > **Calendars**, the account and the calendars you want show **Active**, without **Read only**.
- Set up an appointment booking and use **Check available times** there. The times shown should match your working hours and your calendar.

## Common problems

**The calendar is missing in the appointment booking**: It isn't **Active**, or it is **Read only**. Activate it as described above.

**The agent finds no slots or the wrong ones**: Check working hours, buffers and booking window. More in [Appointments aren't booked](https://docs.qutee.ai/en/fehlerbehebung/termine-werden-nicht-gebucht/).

## Next steps

- [Let your agent book appointments](https://docs.qutee.ai/en/integrationen/termine-buchen-lassen/)
- [Appointments aren't booked](https://docs.qutee.ai/en/fehlerbehebung/termine-werden-nicht-gebucht/)
