Skip to main content

​
Advanced Configuration

Configure your SDK for production use with custom settings, debugging, and optimization.

​
Server Selection

Override the default server URL when needed: 
import { Fathom } from "fathom";

const fathom = new Fathom({
  serverUrl: "https://api.fathom.ai/external/v1",
  security: {
    apiKeyAuth: "YOUR_API_KEY"
  }
});

​
Custom HTTP Client

Customize headers and other HTTP client settings: 
import { Fathom } from "fathom";

const fathom = new Fathom({
  security: {
    apiKeyAuth: "YOUR_API_KEY"
  }
});

​
Standalone Functions (TypeScript Only)

Use standalone functions for bundle size optimization: 
import { listMeetings } from "fathom";

const result = await listMeetings({
  security: {
    apiKeyAuth: "YOUR_API_KEY"
  }
});

for await (const page of result) {
  console.log(page);
}

​
Available Standalone Functions

  • createWebhook - Create a webhook
  • deleteWebhook - Delete a webhook
  • listMeetings - List meetings
  • listTeamMembers - List team members
  • listTeams - List teams

​
Retries (Python Only)

Configure retry strategies for production reliability: 
from fathom_python import Fathom, models
from fathom_python.utils import BackoffStrategy, RetryConfig
import os

with Fathom(
    retry_config=RetryConfig("backoff", BackoffStrategy(1, 50, 1.1, 100), False),
    security=models.Security(
        api_key_auth=os.getenv("FATHOM_API_KEY_AUTH", ""),
    ),
) as fathom:
    res = fathom.list_meetings()
    
    while res is not None:
        res = res.next()

​
Resource Management (Python Only)

Use context managers for proper resource cleanup: 
from fathom_python import Fathom, models
import os

def main():
    with Fathom(
        security=models.Security(
            api_key_auth=os.getenv("FATHOM_API_KEY_AUTH", ""),
        ),
    ) as fathom:
        # Rest of application here...

​
Debugging

Enable debug logging during development: 
import { Fathom } from "fathom";

const fathom = new Fathom({
  security: {
    apiKeyAuth: "YOUR_API_KEY"
  }
});

// Manual debug logging
console.log('Making API request...');
const result = await fathom.listMeetings({});
console.log('Response received:', result);

​
Configuration Best Practices

  1. Use environment variables for sensitive configuration
  2. Implement proper error handling with try-catch blocks
  3. Use context managers (Python) for resource cleanup
  4. Configure timeouts appropriate for your use case
  5. Enable debugging during development
  6. Use standalone functions (TypeScript) for bundle optimization
  7. Configure retries for production reliability
⌘I