thedixitjain Fathom Install & Auth
Overview
Set up Fathom AI API access for retrieving meeting transcripts, summaries, and action items. The API at api.fathom.ai/external/v1 uses X-Api-Key header authentication with per-user API keys.
Prerequisites
- Fathom account (free or Team plan)
- API access enabled in Settings
Instructions
Step 1: Generate API Key
- Log in to https://fathom.video
- Navigate to Settings > Integrations > API Access
- Click Generate API Key
- Copy and store the key securely
export FATHOM_API_KEY="your-api-key-here"
# Verify the key works
curl -s -H "X-Api-Key: ${FATHOM_API_KEY}" \
https://api.fathom.ai/external/v1/meetings?limit=1 | jq .
Step 2: Configure Environment
# .env -- NEVER commit
FATHOM_API_KEY=your-api-key
FATHOM_BASE_URL=https://api.fathom.ai/external/v1
# .gitignore
.env
.env.local
Step 3: Test API Connectivity
# List recent meetings
curl -s -H "X-Api-Key: ${FATHOM_API_KEY}" \
"https://api.fathom.ai/external/v1/meetings?limit=5" \
| jq '.meetings[] | {id: .id, title: .title, date: .created_at}'
Step 4: OAuth Setup (For Public Apps)
# For building integrations others will use, register an OAuth app
# at developers.fathom.ai for marketplace listing eligibility
# OAuth apps cannot use include_transcript or include_summary
# in list requests -- use individual recording endpoints instead
Error Handling
| Error | Cause | Solution |
|---|---|---|
401 Unauthorized |
Invalid API key | Regenerate in Settings > API Access |
403 Forbidden |
Key lacks access | API keys access your meetings + team shared |
429 Too Many Requests |
Rate limit (60/min) | Implement backoff |
| Empty meetings list | No recordings yet | Record a meeting first |
Resources
Next Steps
Proceed to fathom-hello-world to retrieve your first meeting transcript.
Source: jeremylongshore/claude-code-plugins-plus-skills → skills/.curated/fathom-install-auth/SKILL.md
Also appears in: jeremylongshore/claude-code-plugins-plus-skills/plugins/saas-packs/fathom-pack/skills/fathom-install-auth/SKILL.md