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

# Google Calendar

> Sync availability and manage scheduling with Google Calendar integration

## Overview

Firstwork integrates with **Google Calendar** to synchronize availability, create events, and manage scheduling for interviews and meetings. This ensures that your team's existing calendar is respected when candidates book appointments.

## Features

| Feature                | Description                                        |
| ---------------------- | -------------------------------------------------- |
| **Availability Sync**  | Import busy times from Google Calendar             |
| **Event Creation**     | Create calendar events when bookings are confirmed |
| **Conflict Detection** | Prevent double-booking with existing events        |
| **Calendar Invites**   | Send Google Calendar invitations to participants   |
| **Multi-Calendar**     | Support for multiple calendars per user            |

## Setup

### Enable Google Calendar API

Enable the Google Calendar API in your Google Cloud project.

### Configure OAuth

Set up OAuth 2.0 credentials for Google Calendar access in your Google Cloud project.

### Connect calendars

Each team member connects their Google Calendar through the Firstwork dashboard.

## How It Works

### Availability Checking

When a candidate views available time slots:

1. Firstwork checks the host's configured availability schedule
2. Google Calendar events are queried for conflicts
3. Available slots are calculated by removing busy times
4. Slots are presented to the candidate in their timezone

### Event Creation

When a booking is confirmed:

1. A Firstwork event record is created
2. A Google Calendar event is created on the host's calendar
3. Calendar invitations are sent to all participants
4. Reminders are configured based on event settings

### Conflict Handling

If a conflict is detected after booking:

* The booking is flagged for rescheduling
* Notifications are sent to both parties
* Alternative time slots are suggested

## Integration with Calendar Module

Google Calendar enhances the [Calendar & Scheduling](/features/calendar-scheduling) module:

* Availability windows are automatically adjusted based on Google Calendar busy times
* Meet queue assignments respect Google Calendar availability
* Event hosts can manage schedules from either Firstwork or Google Calendar