What the Granola integration enables
| Capability | Description |
|---|
| Automation workflows | Retrieve and process meeting notes, summaries, and transcripts from your Granola workspace |
Prerequisites
Before setting up the Granola integration, you’ll need:
- A Granola Enterprise plan
- Workspace administrator access
- An API key generated from your Granola workspace settings
API access is only available to workspace administrators on the Enterprise plan.
Getting Your API Key
Open workspace settings
In Granola, navigate to Settings → Workspaces.
Go to the API tab
Select the API tab in your workspace settings.
Generate an API key
Click Generate API Key. Copy and save the key immediately — you may not be able to view it again.
Connecting Granola
Navigate to integrations
In Serval, go to Applications and select your application.
Select Granola
Go to the API Integration tab and search for Granola.
Enter your API key
Paste your Granola API key and click Save.
Access and Permissions
API keys provide read access to publicly accessible notes within your workspace. This includes notes shared in workspace-wide folders.
Individual notes that have not been shared to a workspace-wide folder are not accessible via the API.
Rate Limits
Granola applies rate limiting per workspace:
| Limit | Value |
|---|
| Burst capacity | 25 requests per 5-second window |
| Sustained rate | 5 requests/second (300/minute) |
429 Too Many Requests response.
Troubleshooting
Invalid API Key
- Verify the key was copied correctly without extra whitespace
- Confirm the key hasn’t been revoked or regenerated
- Ensure your workspace is on the Enterprise plan
Notes Not Appearing
- Only notes shared in workspace-wide folders are accessible via the API
- Private or individually-shared notes are not returned
Rate Limiting
If you encounter 429 responses, reduce the frequency of requests. The API allows a sustained rate of 5 requests per second.
Additional Resources
