Skip to content
Skills Library
Programming · Building & coding

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

Licence
MIT
Last repository change
26.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

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

fathom API patternsfathom client wrapperfathom Python clientfathom TypeScript
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

  1. Overview
  2. Prerequisites
  3. Instructions
  4. Output
  5. Examples
  6. Python Client
  7. TypeScript Client
  8. Error Handling
  9. Resources
  10. Next Steps
Original SKILL.md headings · 102 lines, 386 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.