Skip to main content
Fathom logo
  • Category: ai meeting assistants
  • Auth: OAUTH2, API_KEY
  • Composio-managed OAuth available? Yes
  • Tools: 10
  • Triggers: 1
  • Slug: FATHOM
  • Version: 20261101_00

Tools

Slug: FATHOM_CREATE_WEBHOOKTool 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

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.
string
required
The endpoint URL where webhook events will be sent. Must be a valid HTTPS URL.
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.
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.
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.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FATHOM_DELETE_WEBHOOKTool to delete an existing webhook by its ID. Use when you need to remove a webhook that is no longer needed.

Input Parameters

string
required
The unique ID of the webhook to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FATHOM_DOWNLOAD_RECORDINGRequest 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

integer
required
The ID of the Fathom meeting recording to download.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FATHOM_GET_RECORDING_DOWNLOADCheck 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

string
required
The download ID returned by FATHOM_DOWNLOAD_RECORDING.
integer
required
The ID of the Fathom meeting recording being downloaded.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FATHOM_GET_RECORDING_SUMMARYTool 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

integer
required
The identifier for the specific meeting recording.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FATHOM_GET_RECORDING_TRANSCRIPTTool 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

integer
required
The ID of the meeting recording to fetch the transcript for.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FATHOM_LIST_MEETINGSRetrieve 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

array
Filter by team names. Provide a list of team names.
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.
array
Filter by recorder email addresses. Provide a list of email addresses.
string
Filter meetings created after this ISO 8601 timestamp (e.g., ‘2024-01-01T00:00:00Z’).
string
Filter meetings created before this ISO 8601 timestamp (e.g., ‘2024-12-31T23:59:59Z’).
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.
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.
boolean
Include linked CRM data in the response. Default is false.
boolean
Include action items data in the response. Default is false.
array
Filter by company domains (exact match). Provide a list of domains.
string ("all" | "only_internal" | "one_or_more_external")
Filter by domain type. Options: ‘all’ (default), ‘only_internal’, ‘one_or_more_external’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FATHOM_LIST_MEETING_TYPESList the organization’s active and inactive meeting types.

Input Parameters

string
Pagination cursor returned as next_cursor by a previous call.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FATHOM_LIST_TEAM_MEMBERSTool 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

string
Team name to filter by. Allows filtering results by specific team.
string
Cursor for pagination. Used for retrieving subsequent pages of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FATHOM_LIST_TEAMSTool 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

string
Cursor for pagination. Use the next_cursor value from a previous response to get the next page of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not

Triggers

Slug: FATHOM_MEETING_CONTENT_READYType: webhookTriggers 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

boolean
Include the meeting’s action items, each with its assignee and a link that opens the recording at that moment.
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.
boolean
Include the meeting’s AI summary in every delivery.
boolean
Include the full speaker-attributed transcript. An hour-long call adds hundreds of KB to every delivery.
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

array
Action items extracted from the meeting. Present only when the trigger was created with action items included; empty when the meeting produced none.
array
required
Everyone on the calendar invite, with their internal/external flag. Empty for a recording with no calendar event.
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.
string
required
ISO 8601 timestamp for when the meeting record was created.
object
CRM records matched to the meeting’s attendees. Either the three record lists or error arrives, never both.
object
The AI-generated summary of the meeting.
string
The calendar event’s title. Null when the recording has no associated calendar meeting.
string
Name of the Fathom meeting type assigned to this meeting, e.g. ‘Quarterly Business Review’. Null or absent when none is assigned.
string
The join URL from the calendar event (Zoom, Google Meet, Microsoft Teams or a Slack huddle). Null when there is no calendar meeting.
object
required
The Fathom user who recorded the meeting.
string
required
ISO 8601 timestamp for when recording actually ended.
integer
The meeting recording’s id — the stable key for this meeting across Fathom’s other endpoints.
string
required
ISO 8601 timestamp for when recording actually started.
string
ISO 8601 scheduled end from the calendar event.
string
ISO 8601 scheduled start from the calendar event.
string
required
Public share URL for the recording.
string
Who the meeting is shared with inside the organisation: ‘no_teams’ (private to the recorder), ‘single_team’, ‘multiple_teams’ or ‘all_teams’.
string
required
The Fathom recording’s title.
array
Speaker-attributed transcript lines. Present only when the trigger was created with transcripts included.
string
Detected language of the transcript, e.g. ‘en’. Can also be the literal ‘unknown’, so it is not always a language code.
string
required
Fathom URL for the call, for its owner and anyone with access.