fathom-sdk-patterns
/fathom-sdk-patterns
Production-ready Fathom API client patterns in Python and TypeScript. Use when building reusable Fathom clients, implementing meeting data pipelines, or wrapping the Fathom REST API. Trigger with phrases like "fathom API patterns", "fathom client wrapper", "fathom Python client", "fathom TypeScript".
- Author
- jeremylongshore ↗
- Repository
- tons-of-skills-marketplace ↗
- Licence
- MIT
- Last repository change
- 26.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 3
No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Production-ready Fathom API client patterns in Python and TypeScript. Use when building reusable Fathom clients, implementing meeting data pipelines, or wrapping the Fathom REST API. Trigger with phrases like "fathom API patterns", "fathom client wrapper", "fathom Python client", "fathom TypeScript".
Triggers from the description
Original author description
Production-ready Fathom API client patterns in Python and TypeScript. Use when building reusable Fathom clients, implementing meeting data pipelines, or wrapping the Fathom REST API. Trigger with phrases like "fathom API patterns", "fathom client wrapper", "fathom Python client", "fathom TypeScript".
How it works
- Overview
- Prerequisites
- Instructions
- Output
- Examples
- Python Client
- TypeScript Client
- Error Handling
- Resources
- Next Steps
SKILL.md preview
---
name: fathom-sdk-patterns
description: 'Production-ready Fathom API client patterns in Python and TypeScript.
Use when building reusable Fathom clients, implementing meeting data pipelines,
or wrapping the Fathom REST API.
Trigger with phrases like "fathom API patterns", "fathom client wrapper",
"fathom Python client", "fathom TypeScript".
'
allowed-tools: Read, Write, Edit
version: 1.6.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
tags:
- saas
- meeting-intelligence
- ai-notes
- fathom
compatibility: Designed for Claude Code
---
# Fathom SDK Patterns
## Overview
Build a narrow Fathom client boundary that makes consent, data handling, idempotency, redaction, and human ownership explicit.
## Prerequisites
- Scoped development credentials, an approved recording/data policy, synthetic fixtures, and existing test conventions.
## Instructions
1. Inject credentials only from the approved secret manager and validate request/response contracts at the boundary.
2. Use stable IDs, bounded retries, and redacted telemetry for sync/follow-up actions.
3. Unit-test with mocks and run one synthetic development integration check before promotion.
## Output
- A test-backed SDK boundary with scoped credentials, safe errors, redacted observability, and rollback-friendly behavior.
## Examples
Instantiate the client with a development secret reference, send a synthetic meeting/action event with an idempotency key, and assert the mocked CRM-sync payload. Record only opaque IDs/results; never log a recording, transcript, contact, or token.
## Python Client
```python
import os, requests
from dataclasses import dataclass
from typing import Optional
@dataclass
class FathomConfig:
api_key: str
base_url: str = "https://api.fathom.ai/external/v1"
timeout: int = 30
class FathomClient:
def __init__(self, config: Optional[FathomConfig] = None):
self.config = config or FathomConfig(api_key=os.environ["FATHOM_API_KEY"])
self.session = requests.Session()
self.session.headers.update({"X-Api-Key": self.config.api_key})
def list_meetings(self, limit: int = 20, **filters) -> list[dict]:
params = {"limit": limit, **filters}
resp = self.session.get(f"{self.config.base_url}/meetings", params=params, timeout=self.config.timeout)
resp.raise_for_status()
return resp.json().get("meetings", [])
def get_transcript(self, recording_id: str) -> dict:
resp = self.session.get(f"{self.config.base_url}/recordings/{recording_id}/transcript", timeout=self.config.timeout)
resp.raise_for_status()
return resp.json()
def get_summary(self, recording_id: str) -> dict:
resp = self.session.get(f"{self.config.base_url}/recordings/{recording_id}/summary", timeout=self.config.timeout)
resp.raise_for_status()
return resp.json()
```
## TypeScript Client
```typescript
class FathomClient {
private apiKey: string;
private baseUrl: string;
constructor(apiKey?: string) {
this.apiKey = apiKey ?? process.env.FATHOM_API_KEY!;
this.baseUrl = "https://api.fathom.ai/external/v1";
}
private async get<T>(path: string, params?: Record<string, string>): Promise<T> {
const url = new URL(`${this.baseUrl}${path}`);
if (params) Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
const resp = await fetch(url, { headers: { "X-Api-Key": this.apiKey } });
if (!resp.ok) throw new Error(`Fathom ${resp.status}: ${await resp.text()}`);
return resp.json();
}
async listMeetings(limit = 20) { return this.get<{meetings: any[]}>("/meetings", {limit: String(limit)}); }
async getTranscript(id: string) { return this.get(`/recordings/${id}/transcript`); }
async getSummary(id: string) { return this.get(`/recordings/${id}/summary`); }
}
```
## Error Handling
| Status | Meaning | Action |
|--------|---------|--------|
| 401 | Invalid API key | Regenerate key |
| 404 | Recording not found | Verify recording ID |
| 429 | Rate limited (60/min) | Backoff and retry |
## Resources
- [Fathom API Reference](https://developers.fathom.ai/api-reference)
## Next Steps
Apply in `fathom-core-workflow-a` for meeting analytics.
Versions
The database has no other skills named fathom-sdk-patterns.
Identical content appears in 1 other GitHub folders. We show one copy with the highest score.
Database snapshot: 13.11.2026 · package version 1998c1a32c57 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100fathom-install-auth
Configure Fathom AI meeting assistant API access with API key authentication. Use when setting up Fathom API integration, generating API keys, or configuring webhook access for meeting data. Trigger with phrases like "install fathom", "setup fathom api", "fathom auth", "fathom… - 100fathom-hello-world
Retrieve meeting transcripts and summaries from the Fathom API. Use when fetching meeting data, testing API access, or learning Fathom API response structure. Trigger with phrases like "fathom hello world", "fathom first api call", "get fathom transcript", "fathom meeting data". - 100fathom-webhooks
Receive and verify Fathom (fathom.video / fathom.ai) AI meeting notetaker webhooks. Use when setting up a Fathom webhook handler, debugging webhook-signature verification (Standard Webhooks, whsec_ secret), or processing the "new meeting content ready" payload with the meeting… - 100fathom
Fetch meetings, transcripts, summaries, and action items from Fathom API. Use when user asks to get Fathom recordings, sync meeting transcripts, or fetch recent calls. - 90fathom
Fathom API integration with managed OAuth. Access meeting recordings, transcripts, summaries, and manage webhooks. Use this skill when users want to retrieve meeting content, search recordings, or set up webhook notifications for new meetings. For other third party apps, use the… - 95fathom-to-clickup
Run, debug and improve the Fathom to ClickUp automation in this repo (From Fathom action items, Watch call tasks, mention tasks). Use when: Fathom tasks look wrong, missing, duplicated or unrouted; adding a client; someone asks about the task format; or it's time to review what…