Fathom Install & Auth

Output

• A scoped Fathom credential/integration reference for the intended environment, with a verified low-impact connection test.
• A credential ownership, rotation, and revocation path that protects meeting content and contacts.

Examples

Configure a development credential from the approved secret manager and verify access against a synthetic meeting/test account, recording only environment and result. If a token appears in code, logs, or support material, revoke it immediately and issue a replacement before further diagnosis.

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

1. Log in to https://fathom.video
2. Navigate to Settings > Integrations > API Access
3. Click Generate API Key
4. 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

Resources

• Fathom API Docs
• Fathom API Quickstart
• Fathom Help Center

Next Steps

Proceed to fathom-hello-world to retrieve your first meeting transcript.