> fathom-common-errors
Diagnose and fix Fathom API errors including auth failures and missing data. Use when API calls fail, transcripts are empty, or webhooks are not firing. Trigger with phrases like "fathom error", "fathom not working", "fathom api failure", "fix fathom".
curl "https://skillshub.wtf/jeremylongshore/claude-code-plugins-plus-skills/fathom-common-errors?format=md"Fathom Common Errors
Error Reference
1. 401 Unauthorized
Fix: Regenerate API key at Settings > Integrations > API Access.
2. 429 Rate Limited
Limit: 60 calls per minute across all API keys. Fix: Implement exponential backoff. Batch requests.
3. Empty Transcript
Causes: Meeting still processing, recording too short, or audio quality issues. Fix: Wait 5-10 minutes after recording. Check recording in Fathom UI.
4. Missing Summary
Cause: AI processing not complete. Fix: Poll the recording endpoint until summary is available.
5. Webhook Not Firing
Fix: Verify webhook URL in Settings > Integrations > Webhooks. Test with:
curl -X POST https://your-url.com/webhooks/fathom \
-H "Content-Type: application/json" \
-d '{"type": "test"}'
6. OAuth Token Expired
Fix: Refresh the access token using your refresh token.
Quick Diagnostics
# Test API key
curl -s -o /dev/null -w "%{http_code}" -H "X-Api-Key: ${FATHOM_API_KEY}" \
https://api.fathom.ai/external/v1/meetings?limit=1
Resources
Next Steps
For diagnostics, see fathom-debug-bundle.
> related_skills --same-repo
> fathom-cost-tuning
Optimize Fathom API usage and plan selection. Trigger with phrases like "fathom cost", "fathom pricing", "fathom plan".
> fathom-core-workflow-b
Sync Fathom meeting data to CRM and build automated follow-up workflows. Use when integrating Fathom with Salesforce, HubSpot, or custom CRMs, or creating automated post-meeting email summaries. Trigger with phrases like "fathom crm sync", "fathom salesforce", "fathom follow-up", "fathom post-meeting workflow".
> fathom-core-workflow-a
Build a meeting analytics pipeline with Fathom transcripts and summaries. Use when extracting insights from meetings, building CRM sync, or creating automated meeting follow-up workflows. Trigger with phrases like "fathom analytics", "fathom meeting pipeline", "fathom transcript analysis", "fathom action items sync".
> fathom-ci-integration
Test Fathom integrations in CI/CD pipelines. Trigger with phrases like "fathom CI", "fathom github actions", "test fathom pipeline".