Granola
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.
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
- Log in to your Granola workspace as an administrator.
- Navigate to Settings > Workspaces.
- Select the API tab.
- Click Generate API Key.
- Copy the generated API key and store it securely.
Set up the Granola connector in Airbyte
- Enter a Name for the Granola source connector.
- Enter your API Key.
- (Optional) Enter a Start Date in
YYYY-MM-DDformat. 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. - 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.