> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fathom

> AI meeting assistant that records, transcribes, and summarizes meetings

![Fathom logo](https://mintcdn.com/composio-preview/r7CO9m4_UWMVFnU7/images/toolkits/fathom.svg?fit=max\&auto=format\&n=r7CO9m4_UWMVFnU7\&q=85\&s=ee60bd098dc55058b0218293f846cf33)

* **Category:** ai meeting assistants
* **Auth:** OAUTH2, API\_KEY
* **Composio-managed OAuth available?** Yes
* **Tools:** 10
* **Triggers:** 1
* **Slug:** `FATHOM`
* **Version:** 20261101\_00

## Tools

> [accordion] Create webhook for meeting content
>
> **Slug:** `FATHOM_CREATE_WEBHOOK`
>
> Tool to create a webhook to receive new meeting content from Fathom. Use when you need to set up notifications for meeting recordings. At least one of transcript, CRM matches, summary, or action items must be included in the webhook payload.
>
> #### Input Parameters
>
> **triggered\_for** `array` *required*
>
> Recording types to monitor. Valid values: 'my\_recordings', 'shared\_external\_recordings', 'my\_shared\_with\_team\_recordings', 'shared\_team\_recordings'. Must provide at least one type.
>
> **destination\_url** `string` *required*
>
> The endpoint URL where webhook events will be sent. Must be a valid HTTPS URL.
>
> **include\_summary** `boolean`
>
> Whether to include meeting summaries in webhook payloads. At least one of include\_transcript, include\_summary, include\_action\_items, or include\_crm\_matches must be True.
>
> **include\_transcript** `boolean`
>
> Whether to include meeting transcripts in webhook payloads. At least one of include\_transcript, include\_summary, include\_action\_items, or include\_crm\_matches must be True.
>
> **include\_crm\_matches** `boolean`
>
> Whether to include CRM data matches in webhook payloads. At least one of include\_transcript, include\_summary, include\_action\_items, or include\_crm\_matches must be True.
>
> **include\_action\_items** `boolean`
>
> Whether to include extracted action items in webhook payloads. At least one of include\_transcript, include\_summary, include\_action\_items, or include\_crm\_matches must be True.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Webhook
>
> **Slug:** `FATHOM_DELETE_WEBHOOK`
>
> Tool to delete an existing webhook by its ID. Use when you need to remove a webhook that is no longer needed.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique ID of the webhook to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Recording
>
> **Slug:** `FATHOM_DOWNLOAD_RECORDING`
>
> Request a downloadable file for a Fathom recording. If generation is still processing, this tool briefly polls for completion and returns the latest status. Completed responses include a short-lived signed URL for the generated audio or video artifact.
>
> #### Input Parameters
>
> **recording\_id** `integer` *required*
>
> The ID of the Fathom meeting recording to download.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Recording Download
>
> **Slug:** `FATHOM_GET_RECORDING_DOWNLOAD`
>
> Check a Fathom recording download that is still processing. Use the recording ID and download ID returned by FATHOM\_DOWNLOAD\_RECORDING. Completed responses include a signed audio or video URL that expires at the returned expires\_at timestamp.
>
> #### Input Parameters
>
> **download\_id** `string` *required*
>
> The download ID returned by FATHOM\_DOWNLOAD\_RECORDING.
>
> **recording\_id** `integer` *required*
>
> The ID of the Fathom meeting recording being downloaded.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Recording Summary
>
> **Slug:** `FATHOM_GET_RECORDING_SUMMARY`
>
> Tool to retrieve the AI-generated summary for a specific recording. Use when you need to access the summary of a meeting recording. Supports both synchronous mode (returns summary directly) and asynchronous mode (delivers summary to webhook URL specified in destination\_url parameter).
>
> #### Input Parameters
>
> **recording\_id** `integer` *required*
>
> The identifier for the specific meeting recording.
>
> **destination\_url** `string`
>
> Webhook URL for asynchronous delivery of the summary. If provided, the endpoint behaves asynchronously and returns a confirmation. If omitted, returns the summary directly (synchronous mode).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Recording Transcript
>
> **Slug:** `FATHOM_GET_RECORDING_TRANSCRIPT`
>
> Tool to retrieve the full transcript for a specific recording. Use when you need to access the complete meeting transcript with speaker information and timestamps. Can operate synchronously (returns transcript directly) or asynchronously (posts transcript to a destination URL). In the response, speaker is an object — access speaker.display\_name rather than treating speaker as a string. Prefer this tool over fetching transcripts via list-meetings calls with include\_transcript=true, which produces extremely large responses when many meetings are returned.
>
> #### Input Parameters
>
> **recording\_id** `integer` *required*
>
> The ID of the meeting recording to fetch the transcript for.
>
> **destination\_url** `string`
>
> Optional destination URL for asynchronous transcript delivery via POST. If provided, the transcript will be posted to this URL instead of being returned directly.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Meetings
>
> **Slug:** `FATHOM_LIST_MEETINGS`
>
> Retrieve a paginated list of meeting recordings for the authenticated user or organization, with optional filtering by dates, domains, recorder, or teams. Supports data enrichment via include\_\* parameters.
>
> #### Input Parameters
>
> **teams** `array`
>
> Filter by team names. Provide a list of team names.
>
> **cursor** `string`
>
> Pagination cursor for fetching the next page of results. The response includes a `next_cursor` field; paginate through all pages when filtering by date range to avoid missing older recordings.
>
> **recorded\_by** `array`
>
> Filter by recorder email addresses. Provide a list of email addresses.
>
> **created\_after** `string`
>
> Filter meetings created after this ISO 8601 timestamp (e.g., '2024-01-01T00:00:00Z').
>
> **created\_before** `string`
>
> Filter meetings created before this ISO 8601 timestamp (e.g., '2024-12-31T23:59:59Z').
>
> **include\_summary** `boolean`
>
> NOT SUPPORTED FOR OAUTH USERS. This parameter is only available with API key authentication. OAuth authenticated users cannot use this flag on the list endpoint and must fetch summaries via the dedicated GET\_RECORDING\_SUMMARY action for individual recordings. Default is false.
>
> **include\_transcript** `boolean`
>
> NOT SUPPORTED FOR OAUTH USERS. This parameter is only available with API key authentication. OAuth authenticated users cannot use this flag on the list endpoint and must fetch transcripts via the dedicated GET\_RECORDING\_TRANSCRIPT action for individual recordings. Default is false.
>
> **include\_crm\_matches** `boolean`
>
> Include linked CRM data in the response. Default is false.
>
> **include\_action\_items** `boolean`
>
> Include action items data in the response. Default is false.
>
> **calendar\_invitees\_domains** `array`
>
> Filter by company domains (exact match). Provide a list of domains.
>
> **calendar\_invitees\_domains\_type** `string ("all" | "only_internal" | "one_or_more_external")`
>
> Filter by domain type. Options: 'all' (default), 'only\_internal', 'one\_or\_more\_external'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Meeting Types
>
> **Slug:** `FATHOM_LIST_MEETING_TYPES`
>
> List the organization's active and inactive meeting types.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Pagination cursor returned as next\_cursor by a previous call.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Team Members
>
> **Slug:** `FATHOM_LIST_TEAM_MEMBERS`
>
> Tool to retrieve a paginated list of all team members in the organization. Use when you need to view team members, optionally filtered by team name or paginated using a cursor.
>
> #### Input Parameters
>
> **team** `string`
>
> Team name to filter by. Allows filtering results by specific team.
>
> **cursor** `string`
>
> Cursor for pagination. Used for retrieving subsequent pages of results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Teams
>
> **Slug:** `FATHOM_LIST_TEAMS`
>
> Tool to retrieve a paginated list of all teams in the organization. Use when you need to get information about teams accessible through the API.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Cursor for pagination. Use the next\_cursor value from a previous response to get the next page of results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

## Triggers

> [accordion] Meeting Content Ready
>
> **Slug:** `FATHOM_MEETING_CONTENT_READY`
>
> **Type:** webhook
>
> Triggers when a Fathom recording finalizes and its meeting content is ready — the same moment Fathom sends the summary email. Only calls that finalize after this trigger is created fire it; Fathom does not backfill past recordings.
>
> #### Configuration
>
> **include\_action\_items** `boolean`
>
> Include the meeting's action items, each with its assignee and a link that opens the recording at that moment.
>
> **include\_crm\_matches** `boolean`
>
> Include CRM records matched to the meeting's attendees. Reads only your or your team's linked CRM; with none linked, deliveries carry an error message in place of the records.
>
> **include\_summary** `boolean`
>
> Include the meeting's AI summary in every delivery.
>
> **include\_transcript** `boolean`
>
> Include the full speaker-attributed transcript. An hour-long call adds hundreds of KB to every delivery.
>
> **triggered\_for** `array` *required*
>
> Which recordings fire this trigger. `my_recordings` covers your own recordings, is the only value that fires for a private call, and is the only one that works on every plan; `shared_external_recordings` covers recordings shared with you by people outside your team; `my_shared_with_team_recordings` and `shared_team_recordings` are Team Plans only. Start with \["my\_recordings"].
>
> #### Payload
>
> **action\_items** `array`
>
> Action items extracted from the meeting. Present only when the trigger was created with action items included; empty when the meeting produced none.
>
> **calendar\_invitees** `array` *required*
>
> Everyone on the calendar invite, with their internal/external flag. Empty for a recording with no calendar event.
>
> **calendar\_invitees\_domains\_type** `string` *required*
>
> Whether the invitee list is internal-only or includes outside domains: 'only\_internal' or 'one\_or\_more\_external'. This is the field to branch on for external customer call vs internal sync.
>
> **created\_at** `string` *required*
>
> ISO 8601 timestamp for when the meeting record was created.
>
> **crm\_matches** `object`
>
> CRM records matched to the meeting's attendees.  Either the three record lists or `error` arrives, never both.
>
> **default\_summary** `object`
>
> The AI-generated summary of the meeting.
>
> **meeting\_title** `string`
>
> The calendar event's title. Null when the recording has no associated calendar meeting.
>
> **meeting\_type** `string`
>
> Name of the Fathom meeting type assigned to this meeting, e.g. 'Quarterly Business Review'. Null or absent when none is assigned.
>
> **meeting\_url** `string`
>
> The join URL from the calendar event (Zoom, Google Meet, Microsoft Teams or a Slack huddle). Null when there is no calendar meeting.
>
> **recorded\_by** `object` *required*
>
> The Fathom user who recorded the meeting.
>
> **recording\_end\_time** `string` *required*
>
> ISO 8601 timestamp for when recording actually ended.
>
> **recording\_id** `integer`
>
> The meeting recording's id — the stable key for this meeting across Fathom's other endpoints.
>
> **recording\_start\_time** `string` *required*
>
> ISO 8601 timestamp for when recording actually started.
>
> **scheduled\_end\_time** `string`
>
> ISO 8601 scheduled end from the calendar event.
>
> **scheduled\_start\_time** `string`
>
> ISO 8601 scheduled start from the calendar event.
>
> **share\_url** `string` *required*
>
> Public share URL for the recording.
>
> **shared\_with** `string`
>
> Who the meeting is shared with inside the organisation: 'no\_teams' (private to the recorder), 'single\_team', 'multiple\_teams' or 'all\_teams'.
>
> **title** `string` *required*
>
> The Fathom recording's title.
>
> **transcript** `array`
>
> Speaker-attributed transcript lines. Present only when the trigger was created with transcripts included.
>
> **transcript\_language** `string`
>
> Detected language of the transcript, e.g. 'en'. Can also be the literal 'unknown', so it is not always a language code.
>
> **url** `string` *required*
>
> Fathom URL for the call, for its owner and anyone with access.
