> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stardex.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Granola Integration
> Connect personal or workspace Granola notes to Stardex and configure meeting-note syncing.
If you take candidate and client calls with Granola, you already have clean AI summaries and transcripts sitting in another app. Copying them into Stardex by hand means they're late, or they never make it in at all. Connect your Granola account once, and every meeting Granola records gets logged straight onto the right candidate's timeline automatically, no copy-paste, no forwarding notes to yourself.
> 💡 Granola won't sync a note you typed yourself. Only meetings it actually recorded and summarized make it onto a candidate's timeline.
***
## Connecting your Personal Granola account
1. Go to **Settings → Email & other integrations → Notetakers**: [stardex.com/settings?tab=email-calendar\§ion=notetaker](https://stardex.com/settings?tab=email-calendar\§ion=notetaker)
2. Under **Other personal notetakers**, find **Personal Granola** and click **Connect**.
Other personal notetakers with Personal Granola Connect
1. In Granola, go to **Settings → Connectors → API keys → Personal API keys**, click **Create new key**, select the **Personal notes** scope, and generate the key. Creating API keys requires a **Business or Enterprise** Granola plan.
2. Copy the key and paste it into the **Granola API key** field in Stardex, then click **Continue**.
3. Choose **which notes should sync**: **All my notes**, or **Only selected folders**.
> 💡 Stick with **All my notes** unless you have a specific reason to limit syncing to certain folders. If you pick "Only selected folders" and later create a meeting note in a folder you didn't select, it just won't sync, with nothing telling you why. Starting broad avoids that confusion entirely.
4. Choose **what to sync to the candidate timeline**: **AI summary**, **Full transcript**, or both. At least one must be selected.
5. Click **Connect Granola**.
***
## Personal vs. Workspace Granola
Stardex supports two separate Granola connections, and they read different notes in Granola.
| | **Personal Granola** | **Workspace Granola** |
| - | - | - |
| Who can connect it | Any team member, for their own notes | Only **organization admins** |
| Where in Stardex | Settings → Email & other integrations → Notetakers → Other personal notetakers | Settings → Email & other integrations → Notetakers → Other organization notetakers |
| What syncs | Meetings Granola recorded and summarized that you own, or that were shared directly with you | Meetings Granola recorded and summarized that are workspace-visible: notes shared to the workspace and notes from Granola Spaces that opted in |
| What's excluded | Notes you typed yourself in Granola, since there's no AI-recorded meeting behind them | Notes you typed yourself, plus any of your private notes that were never shared to the workspace |
To connect the workspace version, follow the same steps above, starting from **Other organization notetakers** on the same Notetakers page: [stardex.com/settings?tab=email-calendar\§ion=notetaker](https://stardex.com/settings?tab=email-calendar\§ion=notetaker). Only admins will see **Connect** here. In Granola, the API key comes from **Settings → Connectors → Workspace API keys** instead of Personal API keys, and only a Granola admin can generate that key.
Other organization notetakers with Granola workspace Connect
***
## How synced notes show up on a candidate's profile
* **It's not instant.** After a call ends, Granola needs a few minutes to finish processing the recording and generate its summary before Stardex can pull it in. Give it a few minutes before checking the candidate's profile.
* **Each meeting can create up to two activities**: a **Meeting Note** (the AI summary) and a **Meeting Transcript** (the full transcript), whichever you left checked in "What to sync to the candidate timeline." Both link back to the source with a **View in Granola** link at the top.
* **Matching works by email first, then name.** Stardex checks each meeting attendee's email against your People and Candidates records. If there's no email match, it falls back to matching by name.
* **No match, or no attendee list?** It lands in **Unassigned Activities** on your Home page instead of being lost, so you can manually assign it to the right person.
***
## Reconnecting if your key stops working
If your Personal Granola API key is revoked or expires, Stardex flags the connection with an **Action needed** badge and the **Manage** button becomes **Reconnect**. We also email you directly when this happens, so you don't have to notice it yourself.
***
## Common use cases
* **Automatic call notes on candidate profiles**: every screening or interview call gets logged without anyone remembering to copy it over.
* **Full searchable transcripts**: keep the entire conversation on the candidate's timeline, not just a summary, so you can go back and check exact wording later.
* **Team-wide visibility on shared calls**: connect Workspace Granola so calls taken by anyone on the team land on the right profile, not just the notes of whoever took the call.
***
## FAQ
**Q: Do I need both Personal and Workspace Granola?** No. Connect Personal Granola for your own meetings. Only connect Workspace Granola if you want meetings shared to the whole Granola workspace to sync too. An admin does this once for the team.
**Q: Will my private Granola notes ever be visible to my team through the Workspace connection?** No. A workspace API key can only see notes that are workspace-visible: notes shared to the workspace and notes from Spaces that opted in. Your private notes stay private regardless of what's connected.
**Q: Why isn't a specific meeting showing up?** Check three things: the meeting needs a few minutes after it ends to sync, it must be a meeting Granola actually recorded and summarized (not a manually typed note), and if you scoped your connection to "Only selected folders," the note needs to live in one of those folders.
**Q: The candidate isn't tagged on the note, where did it go?** If Stardex couldn't match any attendee by email or name, the note goes to **Unassigned Activities** on Home instead of being dropped.
**Q: Can I choose to only sync the summary, not the full transcript?** Yes. Uncheck **Full transcript** and leave **AI summary** checked (or the other way around) in the connection settings
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.