Quickstart

Generate an API key and make your first call

Generate an API Key

Get your Fathom API Key

Head to the Integrations section of your User Settings and generate an API key.

User Settings

API keys are created at the user level. This means your key can only access meetings recorded by you, or those shared to your Team. If you’re an Admin, your API key does not provide access to other users’ unshared meetings.

List recent meetings

List the 10 most recent meetings recorded by you or shared to your team.

cURL

curl https://api.fathom.ai/external/v1/meetings \
     -H "X-Api-Key: YOUR_API_KEY" \
     -d include_transcript=false

Replace YOUR_API_KEY with the API key you generated above.

Here's an example response

Example response

{
"items": [
{
  "title": "Quarterly Business Review",
  "meeting_title": "QBR 2025 Q1",
  "url": "https://fathom.video/xyz123",
  "share_url": "https://fathom.video/share/xyz123",
  "created_at": "2025-03-01T17:01:30Z",
  "scheduled_start_time": "2025-03-01T16:00:00Z",
  "scheduled_end_time": "2025-03-01T17:00:00Z",
  "recording_start_time": "2025-03-01T16:01:12Z",
  "recording_end_time": "2025-03-01T17:00:55Z",
  "meeting_type": "internal",
  "transcript_language": "en",
  "calendar_invitees": [
    {
      "is_external": false,
      "name": "Alice Johnson",
      "email": "[e-mail]"
    }
  ],
  "recorded_by": {
    "name": "Alice Johnson",
    "email": "[e-mail]",
    "team": "Marketing"
  },
  "transcript": [
    {
      "speaker": {
        "display_name": "Alice Johnson",
        "matched_calendar_invitee_email": "[e-mail]"
      },
      "text": "Let's revisit the budget allocations.",
      "timestamp": "00:05:32"
    }
  ],
  "default_summary": {
    "template_name": "general",
    "markdown_formatted": "## Summary\nWe reviewed Q1 OKRs, identified budget risks, and agreed to revisit projections next month.\n"
  },
  "action_items": [
    {
      "description": "Email revised proposal to client",
      "user_generated": false,
      "completed": false,
      "recording_timestamp": "00:10:45",
      "recording_playback_url": "https://fathom.video/xyz123#t=645",
      "assignee": {
        "name": "Alice Johnson",
        "email": "[e-mail]",
        "team": "Marketing"
      }
    }
  ],
  "crm_matches": {
    "contacts": [
      {
        "name": "Jane Smith",
        "email": "[e-mail]",
        "record_url": "https://app.hubspot.com/contacts/123"
      }
    ],
    "companies": [
      {
        "name": "Acme Corp",
        "record_url": "https://app.hubspot.com/companies/456"
      }
    ],
    "deals": [
      {
        "name": "Q1 Renewal",
        "amount": 50000,
        "record_url": "https://app.hubspot.com/deals/789"
      }
    ],
    "error": "no CRM connected"
  }
}
],
"limit": 1,
"next_cursor": "eyJwYWdlX251bSI6Mn0="
}

Next steps

Now that you you’ve made your first API call, time to go deeper:

API documentation

See all available endpoints and methods

Webhooks

Set up a webhook

SDKs

Use our Typescript or Python SDK

OAuth

Build a Fathom integration with OAuth