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

# Calendar

> Connect your calendar to sync 1:1s, or start, add, remove, and restore meetings yourself.

Connect [Google Workspace](https://help.gowindmill.com/integrations/google-workspace.md) or [Outlook Calendar](https://help.gowindmill.com/integrations/outlook-calendar.md) so meetings from your calendar appear in Windmill. If a 1:1 is missing, you can add it yourself. You can also start a 1:1 without a calendar event.

## Which calendar events appear as 1:1s

Meetings with two participants and a title such as "1:1," the participants' names, or "Weekly check-in" usually appear in Windmill after your calendar syncs.

Not every two-person meeting is a 1:1. Interviews, working sessions, and social events remain regular calendar meetings when their purpose is clear from the title or description.

A 1:1 does not have to be between a manager and direct report. Meetings between peers or people in different departments can also appear in Windmill.

Windmill counts people, not email addresses. If an invite's attendees match exactly two people in Windmill, including any secondary emails linked to their profiles, it can appear as a 1:1. Google meeting rooms and resources are ignored. If the invite includes anyone else, such as an outside guest, an email that isn't linked to a Windmill profile, or a third teammate (even one who declined), it isn't added automatically. You can add it yourself and choose who the 1:1 is with.

## Start a 1:1

Use **Start 1:1** to begin an impromptu 1:1. No calendar event is required.

**1. Open My 1:1s**

Go to the [1:1s page](https://app.gowindmill.com/COMPANY/one-on-ones).

**2. Select Start 1:1**

Open **Actions**, then select **Start 1:1**.

**3. Choose an employee**

Select the person, then click **Start 1:1**.

## Add a 1:1 from your calendar

Add a calendar event yourself when it is missing from Windmill or includes people beyond the two in the 1:1.

**1. Open My 1:1s**

Go to the [1:1s page](https://app.gowindmill.com/COMPANY/one-on-ones).

**2. Select Add 1:1 from calendar**

Open **Actions**, then select **Add 1:1 from calendar**.

**3. Choose the event and participant**

Select a shared calendar event. If the event has additional attendees, choose the person for this 1:1.

**4. Choose the recurring scope**

For a recurring event, select **This event** or **This and future events**, then click **Add 1:1**.

Choosing one participant from a larger event creates one 1:1 pair. Repeat the process if the event contains another person you also meet with individually.

## Remove a 1:1

Remove a meeting when it should not appear as a 1:1 in Windmill. Its existing notes remain available in the notes archive.

**1. Open the 1:1 pair**

Go to the [1:1s page](https://app.gowindmill.com/COMPANY/one-on-ones).
Select the person, then find the meeting you want to remove.

**2. Select Remove 1:1**

Open the meeting's three-dot menu and select **Remove 1:1**.

**3. Choose which occurrences to remove**

For a recurring event, select **Only this occurrence** or **All occurrences**, then confirm **Remove 1:1**.

## When a calendar event changes

Windmill keeps your 1:1 list in sync when the original calendar event changes:

* **Cancelled** appears when the calendar event is cancelled or removed.
* **No longer a 1:1** appears when the person you meet with is removed from the invitation or their Windmill account is archived.

Select the status next to the meeting to review why it changed. Depending on the event, you can:

* **Restore this 1:1:** Add the meeting back to your 1:1 list.
* **Remove this 1:1:** Remove only this occurrence.
* **Remove this and future 1:1s:** Remove this occurrence and future events in the recurring series.

## When a calendar series changes

In Google Calendar, if you have a recurring 1:1 (i.e. weekly every Tuesday @ 10 AM), it is common to make changes to all meetings, all future meetings, or a single meeting. Some examples:

* Adding a Zoom link to all meetings
* Moving all future meetings to Wednesday
* Moving a single meeting forward by 30 minutes

From a user perspective, this process feels seamless within Google Calendar. However, the way Google represents this on its backend (which Windmill integrates with) is much more complex. For example, if you reschedule all 1:1s on and after October 13th from Tuesday to Wednesday, Google Calendar does the following:

* Shortens the original Tuesday weekly series to end on October 13th
* Cancels all events in the original Tuesday series on and after October 13th
* Creates a new Wednesday weekly series starting on October 14th
* Creates new events for every Wednesday within the new series

Since Windmill keeps your 1:1s in sync with the underlying Google Calendar event, this can lead to some unexpected behavior when changes occur to a series.

To remedy this, we've implemented a system which:

* Tracks all of your recurring meetings in Google Calendar
* Detects when an old one gets cancelled and a new one gets created
* Ignores the cancellations and moves your 1:1s to the updated time

For example, if you reschedule your 1:1s from Tuesday to Wednesday, Google will tell us you cancelled all your Tuesday meetings, but in Windmill we simply move the 1:1s to the updated time.

This works seamlessly in almost all cases. The one exception is cadence changes; i.e. if you change a weekly 1:1 to a monthly 1:1, Windmill cannot one-to-one map the old meetings to the new meetings and will fall back to cancelling the weekly 1:1s and creating new monthly 1:1s.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.