Granola

<HideInUI>

This page contains the setup guide and reference information for the Granola source connector. Granola is an AI-powered meeting notes tool. This connector reads meeting notes from a Granola workspace using the Granola Enterprise API.

</HideInUI>

Prerequisites

• A Granola workspace on the Enterprise plan
• A Granola Enterprise API key, generated by a workspace administrator. Each workspace can have up to 5 API keys.

Setup guide

Generate an API key

1. Log in to your Granola workspace as an administrator.
2. Navigate to Settings > Workspaces.
3. Select the API tab.
4. Click Generate API Key.
5. Copy the generated API key and store it securely.

Set up the Granola connector in Airbyte

1. Enter a Name for the Granola source connector.
2. Enter your API Key.
3. (Optional) Enter a Start Date in YYYY-MM-DD format. The connector replicates notes created on or after this date. If you leave this field empty, the connector defaults to replicating notes from the last two years.
4. Click Set up source and wait for the connection test to complete.

Supported sync modes

The Granola source connector supports the following sync modes:

Feature	Supported?
Full Refresh Sync	Yes
Full Refresh Sync - Overwrite	Yes
Incremental Sync	Yes
Incremental Sync - Append	Yes

Supported streams

The Granola source connector supports the following stream:

Stream	Sync mode	Primary key
notes	Incremental	id

Notes

The notes stream retrieves meeting notes from your Granola workspace using the GET /v1/notes endpoint. Each record includes the note ID, title, object type, owner name and email, and creation timestamp. The API may return additional fields beyond those listed here, and the connector captures them automatically.

For incremental syncs, the connector uses created_at as the cursor field and fetches notes in 30-day time windows.

The Granola Enterprise API only provides access to notes that have been shared in workspace-wide folders. Private notes are not accessible through the API. For more information, refer to the Granola Enterprise API documentation.

This connector does not use the single-note detail endpoint (GET /v1/notes/{note_id}), so fields available only on that endpoint, such as summaries, transcripts, attendees, calendar events, and folder membership, are not included.

Performance considerations

The Granola API enforces rate limits per workspace:

Metric	Value
Burst capacity	25 requests
Time window	5 seconds
Sustained rate	5 requests per second (300/minute)

The connector handles rate limiting automatically by retrying requests when a 429 Too Many Requests response is received.

Changelog

<details> <summary>Expand to review</summary>

Version	Date	Pull Request	Subject
0.1.0	2026-02-25	74033	Add detailed_notes substream with full note content via SubstreamPartitionRouter
0.0.3	2026-02-24	73377	Update dependencies
0.0.2	2026-02-12	73306	Fix pagination: set page_size to API maximum of 30 and improve stop condition
0.0.1	2026-02-11	73238	Initial release

</details>