# Fathom (/integrations/fathom)





{/* MANUAL-CONTENT-START:intro */}

Use [Fathom](https://fathom.video/) to retrieve meeting summaries and transcripts and inspect teams and team members. Provide a Fathom API key and the selected operation's required fields, such as a recording ID. Triggers can start a workflow when new meeting content is ready.

Pass returned meeting data to later steps, such as sending a summary to Slack or extracting action items.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

List meetings, get transcripts and summaries, and list teams and team members. Trigger workflows when new meeting content is ready.

## Actions [#actions]

### Fathom List Meetings [#fathom-list-meetings]

List recent meetings recorded by the user or shared to their team.

<ReferenceDetails>
  #### Input [#input]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Fathom API Key |
  | `includeSummary` | string | No | Include meeting summary (true/false) |
  | `includeTranscript` | string | No | Include meeting transcript (true/false) |
  | `includeActionItems` | string | No | Include action items (true/false) |
  | `includeCrmMatches` | string | No | Include linked CRM matches (true/false) |
  | `includeHighlights` | string | No | Include meeting highlights (true/false) |
  | `createdAfter` | string | No | Filter meetings created after this ISO 8601 timestamp |
  | `createdBefore` | string | No | Filter meetings created before this ISO 8601 timestamp |
  | `recordedBy` | string | No | Filter by recorder email address |
  | `teams` | string | No | Filter by team name |
  | `meetingType` | string | No | Filter by meeting type name |
  | `calendarInviteesDomains` | string | No | Filter by calendar invitee company domain (exact match) |
  | `calendarInviteesDomainsType` | string | No | Filter by invitee domain type: all, only\_internal, or one\_or\_more\_external |
  | `cursor` | string | No | Pagination cursor from a previous response |

  #### Output [#output]

  | Parameter | Type | Description |
  | - | - | - |
  | `meetings` | array | List of meetings |
  | ↳ `title` | string | Meeting title |
  | ↳ `meeting_title` | string | Calendar event title |
  | ↳ `meeting_type` | string | Meeting type name |
  | ↳ `recording_id` | number | Unique recording ID |
  | ↳ `url` | string | URL to view the meeting |
  | ↳ `meeting_url` | string | URL of the underlying video call (Zoom, Meet, Teams, etc.) |
  | ↳ `share_url` | string | Shareable URL |
  | ↳ `created_at` | string | Creation timestamp |
  | ↳ `scheduled_start_time` | string | Scheduled start time |
  | ↳ `scheduled_end_time` | string | Scheduled end time |
  | ↳ `recording_start_time` | string | Recording start time |
  | ↳ `recording_end_time` | string | Recording end time |
  | ↳ `transcript_language` | string | Transcript language |
  | ↳ `calendar_invitees_domains_type` | string | Invitee domain type: only\_internal or one\_or\_more\_external |
  | ↳ `shared_with` | string | Sharing scope: no\_teams, single\_team, multiple\_teams, or all\_teams |
  | ↳ `recorded_by` | object | Recorder details |
  | ↳ `name` | string | Name of the recorder |
  | ↳ `email` | string | Email of the recorder |
  | ↳ `email_domain` | string | Email domain of the recorder |
  | ↳ `team` | string | Recorder team name |
  | ↳ `calendar_invitees` | array | Calendar invitees for the meeting |
  | ↳ `name` | string | Invitee name |
  | ↳ `email` | string | Invitee email |
  | ↳ `email_domain` | string | Invitee email domain |
  | ↳ `is_external` | boolean | Whether the invitee is external |
  | ↳ `matched_speaker_display_name` | string | Matched transcript speaker display name |
  | ↳ `default_summary` | object | Meeting summary |
  | ↳ `template_name` | string | Summary template name |
  | ↳ `markdown_formatted` | string | Markdown-formatted summary |
  | ↳ `transcript` | array | Transcript entries with speaker, text, and timestamp |
  | ↳ `speaker` | object | Speaker information |
  | ↳ `display_name` | string | Speaker display name |
  | ↳ `matched_calendar_invitee_email` | string | Matched calendar invitee email |
  | ↳ `text` | string | Transcript text |
  | ↳ `timestamp` | string | Timestamp (HH:MM:SS) |
  | ↳ `action_items` | array | Action items extracted from the meeting |
  | ↳ `description` | string | Action item description |
  | ↳ `user_generated` | boolean | Whether the action item was user-generated |
  | ↳ `completed` | boolean | Whether the action item is completed |
  | ↳ `recording_timestamp` | string | Timestamp in the recording (HH:MM:SS) |
  | ↳ `recording_playback_url` | string | Playback URL for the action item moment |
  | ↳ `assignee` | object | Assignee details |
  | ↳ `name` | string | Assignee name |
  | ↳ `email` | string | Assignee email |
  | ↳ `team` | string | Assignee team |
  | ↳ `highlights` | array | Meeting highlights with type, summary, text, and start/end time |
  | ↳ `type` | string | Highlight type |
  | ↳ `summary` | string | Highlight summary |
  | ↳ `text` | string | Highlight text |
  | ↳ `start_time` | number | Start time in seconds |
  | ↳ `end_time` | number | End time in seconds |
  | ↳ `crm_matches` | object | Matched CRM contacts, companies, and deals |
  | ↳ `contacts` | array | Matched CRM contacts |
  | ↳ `name` | string | Contact name |
  | ↳ `email` | string | Contact email |
  | ↳ `record_url` | string | CRM record URL |
  | ↳ `companies` | array | Matched CRM companies |
  | ↳ `name` | string | Company name |
  | ↳ `record_url` | string | CRM record URL |
  | ↳ `deals` | array | Matched CRM deals |
  | ↳ `name` | string | Deal name |
  | ↳ `amount` | number | Deal amount |
  | ↳ `record_url` | string | CRM record URL |
  | ↳ `error` | string | CRM match error, if any |
  | `next_cursor` | string | Pagination cursor for next page |
</ReferenceDetails>

### Fathom List Meeting Types [#fathom-list-meeting-types]

List meeting types configured in your Fathom organization.

#### Input [#input-1]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `apiKey` | string | Yes | Fathom API Key |
| `cursor` | string | No | Pagination cursor from a previous response |

#### Output [#output-1]

| Parameter | Type | Description |
| - | - | - |
| `meetingTypes` | array | List of meeting types |
| ↳ `name` | string | Meeting type name |
| ↳ `status` | string | Meeting type status: active or inactive |
| ↳ `created_at` | string | Date the meeting type was created |
| `next_cursor` | string | Pagination cursor for next page |

### Fathom Get Summary [#fathom-get-summary]

Get the call summary for a specific meeting recording.

#### Input [#input-2]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `apiKey` | string | Yes | Fathom API Key |
| `recordingId` | string | Yes | The recording ID of the meeting |

#### Output [#output-2]

| Parameter | Type | Description |
| - | - | - |
| `template_name` | string | Name of the summary template used |
| `markdown_formatted` | string | Markdown-formatted summary text |

### Fathom Get Transcript [#fathom-get-transcript]

Get the full transcript for a specific meeting recording.

#### Input [#input-3]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `apiKey` | string | Yes | Fathom API Key |
| `recordingId` | string | Yes | The recording ID of the meeting |

#### Output [#output-3]

| Parameter | Type | Description |
| - | - | - |
| `transcript` | array | Array of transcript entries with speaker, text, and timestamp |
| ↳ `speaker` | object | Speaker information |
| ↳ `display_name` | string | Speaker display name |
| ↳ `matched_calendar_invitee_email` | string | Matched calendar invitee email |
| ↳ `text` | string | Transcript text |
| ↳ `timestamp` | string | Timestamp (HH:MM:SS) |

### Fathom List Team Members [#fathom-list-team-members]

List team members in your Fathom organization.

#### Input [#input-4]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `apiKey` | string | Yes | Fathom API Key |
| `teams` | string | No | Team name to filter by |
| `cursor` | string | No | Pagination cursor from a previous response |

#### Output [#output-4]

| Parameter | Type | Description |
| - | - | - |
| `members` | array | List of team members |
| ↳ `name` | string | Team member name |
| ↳ `email` | string | Team member email |
| ↳ `created_at` | string | Date the member was added |
| `next_cursor` | string | Pagination cursor for next page |

### Fathom List Teams [#fathom-list-teams]

List teams in your Fathom organization.

#### Input [#input-5]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `apiKey` | string | Yes | Fathom API Key |
| `cursor` | string | No | Pagination cursor from a previous response |

#### Output [#output-5]

| Parameter | Type | Description |
| - | - | - |
| `teams` | array | List of teams |
| ↳ `name` | string | Team name |
| ↳ `created_at` | string | Date the team was created |
| `next_cursor` | string | Pagination cursor for next page |

## Triggers [#triggers]

A trigger starts a workflow when a supported event occurs in this service.

### Fathom New Meeting Content [#fathom-new-meeting-content]

Trigger workflow when new meeting content is ready in Fathom

<ReferenceDetails label="Configuration and outputs">
  #### Configuration [#configuration]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Required to create the webhook in Fathom. |
  | `triggeredFor` | string | No | Which recording types should trigger this webhook. |
  | `includeSummary` | boolean | No | Include the meeting summary in the webhook payload. |
  | `includeTranscript` | boolean | No | Include the full transcript in the webhook payload. |
  | `includeActionItems` | boolean | No | Include action items extracted from the meeting. |
  | `includeCrmMatches` | boolean | No | Include matched CRM contacts, companies, and deals from your linked CRM. |

  #### Output [#output-6]

  | Parameter | Type | Description |
  | - | - | - |
  | `title` | string | Meeting title |
  | `meeting_title` | string | Calendar event title |
  | `recording_id` | number | Unique recording ID |
  | `url` | string | URL to view the meeting in Fathom |
  | `share_url` | string | Shareable URL for the meeting |
  | `created_at` | string | ISO 8601 creation timestamp |
  | `scheduled_start_time` | string | Scheduled start time |
  | `scheduled_end_time` | string | Scheduled end time |
  | `recording_start_time` | string | Recording start time |
  | `recording_end_time` | string | Recording end time |
  | `transcript_language` | string | Language of the transcript |
  | `calendar_invitees_domains_type` | string | Domain type: only\_internal or one\_or\_more\_external |
  | `recorded_by` | object | Recorder details |
  | ↳ `name` | string | Name of the recorder |
  | ↳ `email` | string | Email of the recorder |
  | `calendar_invitees` | array | Array of calendar invitees with name and email |
  | `default_summary` | object | Meeting summary |
  | ↳ `template_name` | string | Summary template name |
  | ↳ `markdown_formatted` | string | Markdown-formatted summary |
  | `transcript` | array | Array of transcript entries with speaker, text, and timestamp |
  | `action_items` | array | Array of action items extracted from the meeting |
  | `crm_matches` | json | Matched CRM contacts, companies, and deals from linked CRM |
</ReferenceDetails>

### Fathom Webhook [#fathom-webhook]

Generic webhook trigger for all Fathom events

<ReferenceDetails label="Configuration and outputs">
  #### Configuration [#configuration-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Required to create the webhook in Fathom. |
  | `triggeredFor` | string | No | Which recording types should trigger this webhook. |
  | `includeSummary` | boolean | No | Include the meeting summary in the webhook payload. |
  | `includeTranscript` | boolean | No | Include the full transcript in the webhook payload. |
  | `includeActionItems` | boolean | No | Include action items extracted from the meeting. |
  | `includeCrmMatches` | boolean | No | Include matched CRM contacts, companies, and deals from your linked CRM. |

  #### Output [#output-7]

  | Parameter | Type | Description |
  | - | - | - |
  | `title` | string | Meeting title |
  | `meeting_title` | string | Calendar event title |
  | `recording_id` | number | Unique recording ID |
  | `url` | string | URL to view the meeting in Fathom |
  | `share_url` | string | Shareable URL for the meeting |
  | `created_at` | string | ISO 8601 creation timestamp |
  | `scheduled_start_time` | string | Scheduled start time |
  | `scheduled_end_time` | string | Scheduled end time |
  | `recording_start_time` | string | Recording start time |
  | `recording_end_time` | string | Recording end time |
  | `transcript_language` | string | Language of the transcript |
  | `calendar_invitees_domains_type` | string | Domain type: only\_internal or one\_or\_more\_external |
  | `recorded_by` | object | Recorder details |
  | ↳ `name` | string | Name of the recorder |
  | ↳ `email` | string | Email of the recorder |
  | `calendar_invitees` | array | Array of calendar invitees with name and email |
  | `default_summary` | object | Meeting summary |
  | ↳ `template_name` | string | Summary template name |
  | ↳ `markdown_formatted` | string | Markdown-formatted summary |
  | `transcript` | array | Array of transcript entries with speaker, text, and timestamp |
  | `action_items` | array | Array of action items extracted from the meeting |
  | `crm_matches` | json | Matched CRM contacts, companies, and deals from linked CRM |
</ReferenceDetails>