> ## 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.

# Roam

> Connect Roam to Windmill so meeting recordings and transcripts can appear in 1:1s, performance reviews, and Windy.

## Benefits of connecting Roam to Windmill

Connecting Roam to Windmill gives your 1:1s and performance reviews context from recorded meetings. Windmill syncs:

* **Meeting metadata** — the meeting title, time, and participants
* **Meeting transcripts** — text from a recorded Roam meeting
* **Roam users** — user records that Windmill maps to employees

When a meeting matches a 1:1, its recording can appear on that 1:1 page. The transcript can also provide context for performance reviews and Windy.

## Connected data

Windmill syncs the following from Roam:

| Data | Description |
| - | - |
| Meeting metadata | Meeting titles, times, and participants |
| Meeting transcripts | Transcript text from recorded Roam meetings |
| Roam users | Names and account details used for employee mapping |

**What is *not* synced:**

* **Audio or video** — Windmill stores transcripts only; raw recordings stay in Roam.
* **Chats or direct messages** — the integration does not sync Roam chat content.
* **Presence or room activity** — the integration does not sync presence, rituals, lounge activity, or shared-room sessions.

## Permissions

To enable the integration, the connecting user must be:

* A **Roam Workspace Admin**, and
* Have access to the **Organization Admin Dashboard**

The integration is read-only and uses a secure OAuth token. Windmill never accesses or stores call audio or video — only the transcript text.

## How this improves performance reviews

Windmill can use meeting transcripts as source context in 1:1s and performance reviews. The transcript can show decisions, project updates, questions, and support that occurred in the meeting.

## Managing org changes

Make Roam user and workspace-membership changes in Roam. Windmill updates its Roam user records during scheduled syncs.

## FAQs

> [accordion] How often does the sync run?
>
> **Hourly.** New meeting recordings and transcripts appear after an incremental sync. You can also run an **Incremental sync** from the connected account's **Syncs** tab.

> [accordion] Does Windmill sync Roam chat or presence data?
>
> No. Windmill does not sync chats, direct messages, presence, rituals, lounge activity, or shared-room sessions from Roam.

> [accordion] Do contractors or part-time staff sync?
>
> Only if they appear as active members in your Roam workspace.

***


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