Connect Granola
Open Hearflow settings to connect your Granola workspace.
Prerequisites
- A Granola account with the desktop app installed
- A Granola API key (created from the desktop app)
Connecting Granola
1
Generate a Granola API key
Open the Granola desktop app, go to Settings → API, click Create new key, and copy the value to your clipboard. Granola API keys start with
grn_.2
Open Hearflow integrations
In Hearflow, go to Settings → Integrations and select Granola.
3
Paste the key
Paste your API key in the secure input and click Connect. Hearflow validates the key immediately and starts a backfill if it succeeds.
Key handling — Granola keys are encrypted at rest with AES-256. They are only decrypted inside the worker process that polls Granola and never exposed in the UI after saving.
How it works
Backfill
Recent Granola notes are pulled when you first connect, including their summaries and transcripts.
Incremental sync
New notes are polled on a schedule and processed automatically as they are created.
Scope
Hearflow reads notes, summaries, and transcripts only. Audio recordings are never downloaded.
Data access and privacy
What we access- Note metadata (title, owner, created and updated timestamps, web URL)
- AI-generated summaries
- Speaker-labeled meeting transcripts
- Calendar event details linked to the note (invitees, organizer, attendees)
- Folder membership for the note
- Audio recordings
- Notes that belong to other Granola workspaces
Rate limits
Hearflow respects Granola’s published rate limits and stays well under them by default:- Burst: up to 25 requests per 5 seconds
- Sustained: up to 5 requests per second per workspace
Disconnecting Granola
1
In Hearflow
Navigate to Settings → Integrations and click Disconnect next to Granola. This deletes the stored API key and stops all future syncs.
2
In Granola
For full revocation, open the Granola desktop app’s Settings → API and delete the key you generated for Hearflow.
Troubleshooting
Invalid API key
Invalid API key
Make sure the key you pasted starts with
grn_. If it does, regenerate the key in the Granola desktop app under Settings → API and paste the new value into Hearflow. Keys can be rotated without losing already-ingested notes.Missing notes or transcripts
Missing notes or transcripts
Granola only returns transcripts after a meeting note has been finalized. If a recent meeting is not yet visible, wait a few minutes and try again.
