CtrlK
BlogDocsLog inGet started
Tessl Logo

granola-sdk-patterns

Zapier automation patterns and Enterprise API integration for Granola. Use when building automated workflows, connecting Granola to 8,000+ apps via Zapier, or querying the Enterprise API for notes and transcripts. Trigger: "granola zapier", "granola automation", "granola API", "granola SDK".

74

Quality

70%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/saas-packs/granola-pack/skills/granola-sdk-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Granola SDK Patterns

Overview

Granola does not have a traditional SDK. Integration is achieved through three channels: Zapier (8,000+ app connections), the Enterprise API (REST, workspace-level read access), and native integrations (Slack, Notion, HubSpot, Attio, Affinity). This skill covers automation patterns for all three.

Prerequisites

  • Granola Business plan ($14/user/month) for Zapier + native CRM
  • Enterprise plan ($35+/user/month) for API access
  • Zapier account for automation workflows

Instructions

Step 1 — Understand Zapier Triggers

Granola provides two Zapier triggers:

TriggerFires WhenUse Case
Note Added to Granola FolderA note is placed in a specific folderAuto-route by meeting type
Note Shared to ZapierYou manually share a note to ZapierSelective sharing for important meetings

Webhook payload data available:

  • title — meeting title from calendar
  • creator_name / creator_email — note creator
  • attendees[] — array of {name, email} objects
  • calendar_event_title — original calendar event name
  • calendar_event_datetime — meeting date/time
  • note_content — the enhanced note content (Markdown)

Step 2 — Build Common Zap Patterns

Pattern 1: Meeting Notes to Notion (auto-archive)

Trigger: Note Added to Granola Folder ("All Meetings")
Action: Notion — Create Database Item
  Database: Meeting Archive
  Title: "{{title}}"
  Date: "{{calendar_event_datetime}}"
  Content: "{{note_content}}"
  Attendees: "{{attendees}}"

Pattern 2: Action Items to Asana/Linear

Trigger: Note Shared to Zapier
Filter: note_content contains "Action Items"
Code Step (JavaScript):
  const lines = inputData.note_content.split('\n');
  const actions = lines
    .filter(l => l.match(/^- \[ \]/))
    .map(l => l.replace('- [ ] ', ''));
  output = actions.map(a => ({task: a}));
Action: Linear — Create Issue (for each action)
  Title: "{{task}}"
  Team: Engineering
  Label: "meeting-action"

Pattern 3: Sales Call Summary to Slack + HubSpot

Trigger: Note Added to Granola Folder ("Sales Calls")
Path A — Slack:
  Action: Post Message to #sales-updates
  Message: |
    *New Sales Call:* {{title}}
    *Attendees:* {{attendees}}

    {{note_content}}

    [View full notes in Granola]

Path B — HubSpot (via Zapier if not using native):
  Action: Find Contact by Email ({{attendees[0].email}})
  Action: Create Engagement Note
    Body: "{{note_content}}"

Pattern 4: Meeting Follow-Up Email

Trigger: Note Shared to Zapier
Action: ChatGPT — Generate Follow-Up Email
  Prompt: "Write a professional follow-up email based on: {{note_content}}"
Action: Gmail — Create Draft
  To: "{{attendees}}"
  Subject: "Follow-up: {{title}}"
  Body: "{{chatgpt_response}}"
Action: Slack — Notify
  Message: "Follow-up draft ready for: {{title}}"

Step 3 — Use the Enterprise API

Available on Enterprise plan. API keys generated at Settings > API Keys (up to 5 per workspace).

# List all accessible notes (paginated)
curl -s "https://api.granola.ai/v0/notes" \
  -H "Authorization: Bearer $GRANOLA_API_KEY" \
  -H "Content-Type: application/json" | jq '.notes[:3]'

# Get a specific note with transcript
curl -s "https://api.granola.ai/v0/notes/{note_id}" \
  -H "Authorization: Bearer $GRANOLA_API_KEY" | jq '{title, summary, action_items}'

API characteristics:

  • Bearer token authentication
  • Read-only access to publicly shared notes within your workspace
  • Rate limited per workspace (429 response when exceeded)
  • Pagination for list endpoints

Reverse-engineered endpoints (unofficial, for reference):

POST https://api.granola.ai/v2/get-documents    # List documents (paginated)
POST https://api.granola.ai/v1/get-document-transcript  # Get transcript
POST https://api.granola.ai/v1/get-workspaces    # List workspaces
POST https://api.granola.ai/v1/get-documents-batch  # Bulk fetch by IDs

Authentication uses WorkOS with refresh token rotation via POST https://api.workos.com/user_management/authenticate.

Step 4 — Multi-Step Automation Chains

Name: Complete Meeting Follow-Up Pipeline

Step 1 — Trigger:
  Granola: Note Added to Folder ("Client Meetings")

Step 2 — Filter:
  Only continue if attendees contain external email domains

Step 3 — Action:
  ChatGPT: Generate structured summary and follow-up email

Step 4 — Action:
  Gmail: Create draft follow-up email to external attendees

Step 5 — Action:
  Notion: Create page in Client Meeting Log database

Step 6 — Action:
  Linear: Create issues from action items with "client" label

Step 7 — Action:
  Slack: Post summary to #client-updates channel

Step 8 — Action:
  HubSpot: Log meeting note on matched Contact/Deal

Step 5 — Folder-Based Routing

Organize Granola folders to drive different Zap behaviors:

FolderZapier TriggerActions
Sales CallsAutoSlack #sales + HubSpot + follow-up email
EngineeringAutoLinear tasks + Notion wiki
All HandsAutoSlack #general + Google Drive archive
InterviewsManual shareGreenhouse scorecard + hiring panel Slack
1-on-1sNonePrivate, no automation

Output

  • Zapier workflows configured for automated note processing
  • API access established for custom integrations
  • Multi-step automation chains routing by meeting type
  • Folder-based routing strategy implemented

Error Handling

ErrorCauseFix
Zapier trigger not firingFolder trigger misconfiguredVerify the exact folder name in Zapier matches Granola
Missing note contentNote still processingAdd a 2-minute delay step at the start of the Zap
API 429 Too Many RequestsRate limit exceededAdd delays between requests, implement backoff
API 401 UnauthorizedInvalid or expired API keyRegenerate key at Settings > API Keys
Attendee data emptyCalendar event has no attendee listAdd attendees to the calendar event

Resources

  • Zapier Granola App
  • Automate Granola (4 Ways)
  • Granola Enterprise API
  • Enterprise API Docs

Next Steps

Proceed to granola-common-errors for troubleshooting.

Repository
jeremylongshore/claude-code-plugins-plus-skills
Last updated
Created

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.