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

# Calendars

> Connect Google, Outlook, Apple or Zoho Calendar so agents book on real availability, or add an ICS feed to block busy times.

When a calendar is connected, the agent checks free and busy times before it offers a slot, then writes the
booking straight onto the calendar. Connect as many calendars as you need: the agent checks all of them for
conflicts.

Connect a calendar from **Settings › Browse apps**. Manage it later in **Settings › Connected apps**. Booking
hours live in **Bookings › Hours**.

| Calendar | Checks availability | Writes bookings | Moves and cancels |
| - | - | - | - |
| Google Calendar | Yes | Yes | Yes |
| Outlook | Yes | Yes | Yes |
| Apple Calendar | Yes | Yes | Yes |
| Zoho Calendar | Yes | Yes | Yes |
| ICS feed | Yes | No | No |

## Google Calendar

Works with personal Gmail and Google Workspace accounts.

**1. Connect**

Choose **Google Calendar** and sign in to your Google account.

**2. Approve access**

RevDesk asks to view your calendars and events, and to create and edit events.

**3. Pick the calendar**

Choose where bookings land. You can change it later.

To offer times, RevDesk reads only whether a window is busy. To find a caller's existing appointment, it
searches your calendar for their email or phone number and reads the matching event's title, time and
attendees. If calendar sync is on for your workspace, RevDesk also stores upcoming events' title, time,
description and location to keep availability current.

Turn on [Google Meet](https://docs.revdesk.com/integrations/video/video-meetings.md#google-meet) to add a video link to bookings.

## Outlook

Works with Outlook.com and Microsoft 365 accounts.

**1. Connect**

Choose **Outlook Calendar** and sign in to your Microsoft account.

**2. Approve access**

RevDesk asks for `Calendars.Read`, `Calendars.ReadWrite`, `User.Read` and `offline_access`, so it can read
busy times, manage the events it books, and stay connected without signing in again.

**3. Pick the calendar**

Choose where bookings land.

To offer times, RevDesk reads only whether a window is busy. To find a caller's existing appointment, it
searches for their email or phone number and reads the matching event's subject, time and attendees. If
calendar sync is on, RevDesk also stores upcoming events' subject, time, body preview and location.

> [!NOTE]
>
> Some Microsoft 365 tenants need an IT admin to approve new apps. If you see "admin approval required," send
> your admin the app details from the prompt. Once they approve, everyone in the tenant can connect.

## Apple Calendar

Connects to iCloud Calendar with an app-specific password. Your Apple ID needs two-factor authentication,
which almost every account already has.

**1. Make an app-specific password**

At [appleid.apple.com](https://appleid.apple.com), open **Sign-In and Security › App-Specific Passwords**,
create one named "RevDesk" and copy it.

**2. Connect**

Choose **Apple Calendar** in RevDesk and enter your Apple ID email and the app-specific password. Your
regular Apple ID password won't work.

**3. Pick the calendar**

Choose the iCloud calendar bookings should land on.

Use an iCloud calendar, not one stored only on one device. Bookings then show on every iPhone, iPad and Mac
signed into that Apple ID.

## Zoho Calendar

For teams already on Zoho.

**1. Connect**

Choose **Zoho Calendar** and sign in to your Zoho account.

**2. Pick the calendar**

Choose where bookings land. Archived calendars don't appear.

## ICS feed

Any calendar that publishes an ICS link can block busy times, so the agent never offers a slot that overlaps.
It's read-only: bookings still land on a calendar you connected above. Use it for a personal calendar or a
teammate on another provider.

**1. Copy the ICS link**

Find it in the source calendar's sharing settings. Use the link ending in `.ics` or containing `/ical/`,
not the web page link.

**2. Connect**

Choose **ICS Feed** in RevDesk and paste the link.

| Calendar | Where to find the ICS link |
| - | - |
| Google Calendar | Settings › Settings for my calendars › Integrate calendar › Secret address in iCal format |
| Outlook.com | Settings › Calendar › Shared calendars › Publish a calendar |
| Apple Calendar | Right-click the calendar › Share Calendar › Public Calendar |

Some feeds only include a limited date range. Check the source calendar's export settings if events are
missing.

## Troubleshooting

> [accordion] A calendar stopped syncing
>
> Reconnect it from **Settings › Connected apps**. Google and Microsoft sometimes end a connection after a
> security change.

> [accordion] Times are off by hours
>
> Make sure the calendar's time zone matches your RevDesk time zone.

> [accordion] A shared calendar is missing from the list
>
> Only calendars you own or can edit appear. Check the calendar's sharing settings.


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