> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://katalyz.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Connecting Google Workspace

The Google Workspace integration unlocks calendar availability for Meeting widgets, email threading, and (on Premium plans) meeting recording via the Katalyz notetaker.

> ⚠️ Workspace-level connection requires org role **Admin**. Individual users connect their own Google accounts in **Settings → Profile → Connected emails**.

## Two levels of connection

### Workspace-wide (Admin) — required first
The org-level connection must be enabled first. Until an Admin does this, individual users can't connect their own accounts.

1. **Settings → Integrations** → Google Workspace → **Connect**
2. Admin authorizes the app for the whole Google Workspace domain
3. Once enabled, individual users can connect their personal accounts

### Per-user (each team member)
After the org-level connection is in place, each team member signs in with their own Google account via OAuth (in **Settings → Profile → Connected emails**) to authorize calendar + email access for themselves. See [Connecting your email](https://katalyz.crisp.help/en/article/connecting-your-email-2xk90j/).

## What Katalyz accesses

The Google OAuth screen lists the exact scopes Katalyz requests:

| Scope | What it allows |
| --- | --- |
| `gmail.send` | Send emails from the user's mailbox on their behalf (room invitations, follow-ups, notifications). |
| `calendar` | Manage the user's calendars (create / update meetings linked from Katalyz). |
| `calendar.events` | Read and write individual calendar events the user is on. |
| `calendar.readonly` | Read availability and existing events to surface them in Katalyz (e.g. the Meeting widget picker). |

## What enables what

| Feature | Requires |
|---|---|
| Meeting widget availability | Per-user calendar connection |
| Email threading in rooms | Per-user email connection |
| Katalyz Recording | Per-user calendar connection (Premium plan) |
| Dedicated email subdomain sending | Workspace admin connection + DNS setup |

## Troubleshooting

- **"Authentication failed"** — Your org's Google admin may block third-party apps. Ask them to allow-list Katalyz.
- **"No calendar availability showing"** — Confirm correct calendar is selected; check privacy settings on events.
- **"Emails not threading"** — Email integration pulls only messages involving room participants. Isolated emails won't link.

## Related articles
- [Connecting your email](https://katalyz.crisp.help/en/article/connecting-your-email-2xk90j/)
- [Connecting Microsoft 365](https://katalyz.crisp.help/en/article/connecting-microsoft-365-du15ia/)
- [Setting up a dedicated email subdomain](https://katalyz.crisp.help/en/article/setting-up-a-dedicated-email-subdomain-1tfsyk4/)