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

# Calendar integrations

> Connect Google Calendar, iCloud, Microsoft Teams, Zoom, and Calendly to the HoopAI Platform to sync appointments and add video conferencing.

<div style={{position: "relative", paddingTop: "56.25%", marginBottom: "1.5rem"}}>
  <iframe src="https://player.mediadelivery.net/embed/622351/e6031010-5ef8-4cfc-ab06-68bfe65c3e81?preload=true" loading="lazy" style={{border: "none", position: "absolute", top: 0, height: "100%", width: "100%"}} allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture" allowFullScreen={true} />
</div>

The HoopAI Platform connects with the most popular calendar and video conferencing services, keeping your schedule in sync and automatically generating meeting links for every appointment.

<Frame caption="Calendar Connections showing available integration options">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/IfenqDY0m-v5LGvA/images/calendars-google-add-new.png?fit=max&auto=format&n=IfenqDY0m-v5LGvA&q=85&s=bcdfdf661996c9a6e080768af4bf5471" alt="Calendar connections overview" width="1406" height="572" data-path="images/calendars-google-add-new.png" />
</Frame>

## Google Calendar

Connecting Google Calendar creates a bi-directional sync — appointments booked in Hoop appear in Google Calendar, and events added in Google Calendar block availability in Hoop.

<Steps>
  <Step title="Open Calendar Connections">
    Navigate to **Calendar Settings** for the calendar you want to connect. Go to **Advanced Settings > Connections**.
  </Step>

  <Step title="Click Connect Google Calendar">
    Select Google Calendar from the list and click **Connect**.

    <Frame caption="Add a new Google Calendar connection from the Connections tab">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/IfenqDY0m-v5LGvA/images/calendars-google-add-new.png?fit=max&auto=format&n=IfenqDY0m-v5LGvA&q=85&s=bcdfdf661996c9a6e080768af4bf5471" alt="Add New connection button" width="1406" height="572" data-path="images/calendars-google-add-new.png" />
    </Frame>
  </Step>

  <Step title="Authenticate with Google">
    Sign in to your Google account and grant the required calendar permissions.

    <Frame caption="Sign in to your Google account to authorize the Hoop connection">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-google-connect1.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=058d491c12c64ac5ecc95dd56a54292e" alt="Google sign-in authorization screen" width="1384" height="756" data-path="images/calendars-google-connect1.png" />
    </Frame>

    <Frame caption="Grant Hoop permission to access your Google Calendar">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-google-connect2.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=5da44c1f36e209a721b5b75181fc3cb5" alt="Google Calendar permission grant" width="1365" height="972" data-path="images/calendars-google-connect2.png" />
    </Frame>
  </Step>

  <Step title="Select the calendar to sync">
    Choose which Google Calendar to sync appointments with.

    <Frame caption="Choose which of your Google Calendars to sync appointments with">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/IfenqDY0m-v5LGvA/images/calendars-google-calendars.png?fit=max&auto=format&n=IfenqDY0m-v5LGvA&q=85&s=2f4f6e1c13aaaa634edda60beae1d8ff" alt="Google Calendar selection screen" width="1177" height="591" data-path="images/calendars-google-calendars.png" />
    </Frame>
  </Step>

  <Step title="Configure sync settings and save">
    Configure any additional options, then click **Save**.

    <Frame caption="Configure sync settings before saving the Google Calendar connection">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-google-configure.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=11f024166003f935eb00a5de170f3ce3" alt="Google Calendar sync configuration" width="1392" height="845" data-path="images/calendars-google-configure.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Connect Google Calendar to prevent double booking — events in your personal Google Calendar will automatically block corresponding slots in Hoop.
</Tip>

***

## Zoom

The Zoom integration automatically generates a unique Zoom meeting link for every appointment booked, eliminating the need to manually create and share meeting links.

<Steps>
  <Step title="Open Calendar Connections">
    Navigate to **Calendar Settings > Advanced Settings > Connections** for your calendar.

    <Frame caption="The Calendar Connections tab showing Zoom as an available option">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/9LAxb-NDhr4pbMZL/images/calendars-zoom-connections.png?fit=max&auto=format&n=9LAxb-NDhr4pbMZL&q=85&s=820aa5d9a40298a34e0ee97529df6097" alt="Calendar Connections tab with Zoom option" width="979" height="402" data-path="images/calendars-zoom-connections.png" />
    </Frame>
  </Step>

  <Step title="Connect Zoom">
    Click **Connect Zoom** to begin the authorization process.

    <Frame caption="Click Connect to start the Zoom authorization flow">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/9LAxb-NDhr4pbMZL/images/calendars-zoom-connect.png?fit=max&auto=format&n=9LAxb-NDhr4pbMZL&q=85&s=e0f187578bd9278a222149039806f53f" alt="Zoom connect button" width="1032" height="489" data-path="images/calendars-zoom-connect.png" />
    </Frame>
  </Step>

  <Step title="Authorize the integration">
    Review the permissions and click **Allow** to grant Hoop access to your Zoom account.

    <Frame caption="Review and Allow the Zoom permissions for Hoop">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/9LAxb-NDhr4pbMZL/images/calendars-zoom-allow.png?fit=max&auto=format&n=9LAxb-NDhr4pbMZL&q=85&s=eedcbe618ae173792ff311a3f476d876" alt="Zoom authorization permissions screen" width="858" height="850" data-path="images/calendars-zoom-allow.png" />
    </Frame>
  </Step>

  <Step title="Confirm and save">
    Once connected, the Zoom integration shows as active. Click **Save**.

    <Frame caption="Zoom integration is now enabled — all new appointments will include a Zoom link">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/9LAxb-NDhr4pbMZL/images/calendars-zoom-enabled.png?fit=max&auto=format&n=9LAxb-NDhr4pbMZL&q=85&s=81895489fcc4b689b771d4b6637f3eda" alt="Zoom integration active confirmation" width="1109" height="541" data-path="images/calendars-zoom-enabled.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  Zoom meeting links are unique per appointment. Each booking generates its own link — links are not reused between appointments.
</Note>

***

## Microsoft Teams

The Microsoft Teams integration adds a Teams meeting link to every appointment confirmation, making virtual meetings seamless for organizations already using Microsoft 365.

<Steps>
  <Step title="Open Calendar Connections">
    In **Calendar Settings**, navigate to the Connections tab for your calendar.

    <Frame caption="Open the Connections tab and select Microsoft Teams">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/9LAxb-NDhr4pbMZL/images/calendars-teams-connect1.png?fit=max&auto=format&n=9LAxb-NDhr4pbMZL&q=85&s=ee923eaa8376b1f28daf8f30fe89fb3e" alt="Calendar Connections with Teams option" width="1336" height="557" data-path="images/calendars-teams-connect1.png" />
    </Frame>
  </Step>

  <Step title="Click Connect Microsoft Teams">
    Select Microsoft Teams from the connections list.

    <Frame caption="Click the Connect button to start the Microsoft Teams setup">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/9LAxb-NDhr4pbMZL/images/calendars-teams-connect2.png?fit=max&auto=format&n=9LAxb-NDhr4pbMZL&q=85&s=4f332473e64a21a10967175920992402" alt="Connect Microsoft Teams button" width="1313" height="475" data-path="images/calendars-teams-connect2.png" />
    </Frame>
  </Step>

  <Step title="Sign in with Microsoft">
    You will be redirected to the Microsoft sign-in page. Enter your Microsoft 365 credentials.

    <Frame caption="Sign in with your Microsoft account to authorize Teams">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/9LAxb-NDhr4pbMZL/images/calendars-teams-connect3.png?fit=max&auto=format&n=9LAxb-NDhr4pbMZL&q=85&s=ae6a26752ca1ec4de91fdf276bc07ffb" alt="Microsoft Teams sign-in screen" width="1303" height="634" data-path="images/calendars-teams-connect3.png" />
    </Frame>
  </Step>

  <Step title="Grant permissions and save">
    Accept the permission request. Click **Save** in Hoop to complete the connection.

    <Frame caption="Complete the sign-in to activate the Teams integration">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/9LAxb-NDhr4pbMZL/images/calendars-teams-signin.png?fit=max&auto=format&n=9LAxb-NDhr4pbMZL&q=85&s=234b3e11f67857bfb65a2be4077e6729" alt="Teams sign-in completion screen" width="609" height="553" data-path="images/calendars-teams-signin.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Microsoft Teams integration requires a Microsoft 365 account with Teams enabled. Personal Microsoft accounts (Outlook.com) are not supported.
</Tip>

***

## iCloud Calendar

The iCloud Calendar integration syncs Hoop appointments with Apple Calendar across all your Apple devices, ensuring your schedule stays up to date on iPhone, iPad, and Mac.

<Steps>
  <Step title="Sign in to Apple ID">
    Go to [appleid.apple.com](https://appleid.apple.com) and sign in with your Apple ID.

    <Frame caption="Sign in to your Apple ID at appleid.apple.com">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-icloud-signin.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=f9ee6c92691621642a50c7c95e7fac08" alt="Apple ID sign-in page" width="1500" height="873" data-path="images/calendars-icloud-signin.png" />
    </Frame>
  </Step>

  <Step title="Enter your Apple ID email">
    Enter the Apple ID associated with your iCloud calendar account.

    <Frame caption="Enter your Apple ID email address to begin">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-icloud-email.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=63ea4993c016568b57f4489e80ce7e99" alt="Apple ID email entry field" width="1500" height="954" data-path="images/calendars-icloud-email.png" />
    </Frame>
  </Step>

  <Step title="Complete two-factor authentication">
    Enter the 6-digit verification code sent to your trusted Apple device.

    <Frame caption="Enter the two-factor authentication code from your trusted device">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-icloud-2fa.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=2b4c08533aedef785d0080a0a98c9a2c" alt="Apple two-factor authentication screen" width="1500" height="1033" data-path="images/calendars-icloud-2fa.png" />
    </Frame>
  </Step>

  <Step title="Navigate to app-specific passwords">
    In your Apple ID security settings, find the **App-Specific Passwords** section and click **Generate Password**.

    <Frame caption="Navigate to App-Specific Passwords in your Apple ID security settings">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-icloud-app-password.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=2e50b6e88795d08756aeaed3d4877086" alt="App-Specific Passwords section in Apple ID settings" width="1500" height="1033" data-path="images/calendars-icloud-app-password.png" />
    </Frame>
  </Step>

  <Step title="Create the password">
    Name the password (e.g., "Hoop") and click **Create**. Copy the generated password — it will only be shown once.

    <Frame caption="Create and copy the app-specific password for Hoop">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-icloud-create.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=c5171c9bf6e0f054f4eca6346573f2e3" alt="Generated app-specific password screen" width="876" height="697" data-path="images/calendars-icloud-create.png" />
    </Frame>
  </Step>

  <Step title="Connect in Hoop">
    In Hoop's Calendar Connections tab, select **iCloud**. Enter your Apple ID email and the app-specific password, then click **Connect**.

    <Frame caption="Enter your Apple ID and app-specific password in the Hoop connection form">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-icloud-connect.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=1361069b6b114ce2ccb8491ad9ba494b" alt="iCloud connection form in Hoop Calendar Settings" width="987" height="683" data-path="images/calendars-icloud-connect.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  App-specific passwords can only be viewed once. Store it securely before closing the Apple ID page.
</Warning>

***

## Calendly

Importing from Calendly brings your existing Calendly event types into the HoopAI Platform, allowing you to consolidate scheduling in one place.

<Steps>
  <Step title="Open Calendar Connections">
    Navigate to **Calendar Settings** and click **Calendar Connections**.

    <Frame caption="Open Calendar Settings and navigate to Calendar Connections">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/IfenqDY0m-v5LGvA/images/calendars-calendly-settings.png?fit=max&auto=format&n=IfenqDY0m-v5LGvA&q=85&s=c011a2d8470120a7efe4f07f9be1cb5b" alt="Calendar Settings showing Calendar Connections" width="543" height="132" data-path="images/calendars-calendly-settings.png" />
    </Frame>
  </Step>

  <Step title="Add a new connection">
    Click **+ Add New** to open the integrations panel.

    <Frame caption="Click + Add New to see all available integrations">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/IfenqDY0m-v5LGvA/images/calendars-calendly-add-new.png?fit=max&auto=format&n=IfenqDY0m-v5LGvA&q=85&s=cfecf825f4a8fed213413c3bd212735f" alt="Add New connection button" width="1037" height="590" data-path="images/calendars-calendly-add-new.png" />
    </Frame>
  </Step>

  <Step title="Select Calendly and connect">
    Choose Calendly from the list and click **Connect**. You will be redirected to Calendly to authorize the integration.

    <Frame caption="Select Calendly and click Connect to authorize the integration">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/IfenqDY0m-v5LGvA/images/calendars-calendly-connect.png?fit=max&auto=format&n=IfenqDY0m-v5LGvA&q=85&s=63a2a9a73ab173b26dc9be0088cf8c31" alt="Calendly connect button" width="1318" height="750" data-path="images/calendars-calendly-connect.png" />
    </Frame>
  </Step>

  <Step title="Review imported events">
    After connecting, Hoop displays the number of Calendly events being synced into your account.

    <Frame caption="Review the number of Calendly events that will be synced">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/IfenqDY0m-v5LGvA/images/calendars-calendly-sync.png?fit=max&auto=format&n=IfenqDY0m-v5LGvA&q=85&s=206d2ca30d7e725ef1a1b09fd7ec627e" alt="Calendly sync count showing imported events" width="1078" height="1018" data-path="images/calendars-calendly-sync.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  Calendly integration is an import only — it does not create a live bi-directional sync. New events created in Calendly after the initial import will not automatically appear in Hoop.
</Note>

***

## Disconnection notifications

When a calendar integration loses its connection — due to expired tokens, revoked permissions, or account changes — HoopAI sends an automatic notification to the account owner. This ensures you are aware of sync issues before they cause missed appointments or double bookings.

Disconnection notifications are sent via email and appear as in-app alerts. To reconnect, go to **Calendar Settings > Advanced Settings > Connections** and re-authenticate the affected integration.

***

## Hiding third-party calendar details

By default, events synced from external calendars (Google, Outlook, iCloud) show their full details in Hoop — including event titles and descriptions. If you prefer to keep external calendar details private and only use them to block availability:

1. Open the calendar's **Advanced Settings > Connections**
2. Find the connected integration
3. Enable **Hide Third-Party Calendar Details**

When enabled, external events appear as "Busy" blocks without titles or descriptions. This is useful when a personal calendar is connected and you do not want team members to see personal event details.

***

## Managing integrations

To view all active calendar connections, go to **Calendar Settings > Calendar Connections**. From here you can:

* **View status** — see which integrations are active, pending, or disconnected
* **Reconfigure** — update sync settings for an existing connection
* **Disconnect** — remove an integration at any time

<AccordionGroup>
  <Accordion title="What if my Google Calendar stops syncing?">
    Disconnect and reconnect the Google Calendar integration in Calendar Connections. This refreshes the OAuth token and usually resolves sync issues. If the problem persists, ensure the Google Calendar account has not had its permissions revoked.
  </Accordion>

  <Accordion title="Can I connect multiple Google accounts?">
    Each calendar can only be connected to one Google Calendar account at a time. If you need to sync a different Google account, disconnect the existing one and reconnect with the new account.
  </Accordion>

  <Accordion title="Do video meeting links work for recurring appointments?">
    Yes. Each occurrence in a recurring series receives its own unique meeting link (for Zoom and Teams). Links are generated at the time of booking.
  </Accordion>
</AccordionGroup>
