# 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". '

- Skill: `thedixitjain/fathom-common-errors` (Agent Skill)
- Install (CLI): `npx skillmds add thedixitjain/fathom-common-errors`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thedixitjain/fathom-common-errors/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: thedixitjain (https://skillmd.com/u/thedixitjain)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/thedixitjain/fathom-common-errors

---


# 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:

```bash
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

```bash
# 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

- [Fathom Help Center](https://help.fathom.video)
- [Fathom API Docs](https://developers.fathom.ai)

## Next Steps

For diagnostics, see `fathom-debug-bundle`.

---

**Source:** [`jeremylongshore/claude-code-plugins-plus-skills`](https://github.com/jeremylongshore/claude-code-plugins-plus-skills) → `plugins/saas-packs/fathom-pack/skills/fathom-common-errors/SKILL.md`