---
title: "New meeting content ready"
method: POST
path: "newMeeting"
tags: ["Webhook Payloads"]
---

# New meeting content ready

`POST newMeeting` (webhook)

Webhook sent to the URL you register in Fathom settings.

## Headers

- `webhook-id` string, required
- `webhook-timestamp` integer, required
- `webhook-signature` string, required

## Payload

- Meeting
  - `title` string, required
  - `meeting_title` string, nullable, required: Calendar event title.
  - `meeting_type` string, nullable, required: The name of the meeting type assigned to this meeting, or `null` if none is assigned.
  - `recording_id` integer, required: The ID of the meeting recording.
  - `url` string, uri, required
  - `meeting_url` string, uri, nullable: The underlying meeting join URL (Zoom, Google Meet, Microsoft Teams, or Slack huddle) from the calendar event. `null` when there is no associated calendar meeting.
  - `share_url` string, uri, required
  - `created_at` string, date-time, required
  - `scheduled_start_time` string, date-time, required
  - `scheduled_end_time` string, date-time, required
  - `recording_start_time` string, date-time, required
  - `recording_end_time` string, date-time, required
  - `calendar_invitees_domains_type` 'only_internal' | 'one_or_more_external', required
  - `shared_with` 'no_teams' | 'single_team' | 'multiple_teams' | 'all_teams', required: Who the meeting is shared with within your organization. `no_teams`: private to the recorder. `single_team`: shared with one team. `multiple_teams`: shared with multiple teams. `all_teams`: shared with everyone in the organization.
  - `transcript_language` string, required
  - `transcript` TranscriptItem[], nullable
    - `speaker` TranscriptItemSpeaker, required
      - `display_name` string, required
      - `matched_calendar_invitee_email` string, email, nullable: The email address of the calendar invitee matching this speaker. Null if no exact match found.
    - `text` string, required
    - `timestamp` string, required: Timestamp relative to the start of the meeting (HH:MM:SS).
  - `default_summary` MeetingSummary
    - `template_name` string, nullable, required
    - `markdown_formatted` string, nullable, required: Always displayed in English.
  - `action_items` ActionItem[], nullable
    - `description` string, required: Always displayed in English.
    - `user_generated` boolean, required
    - `completed` boolean, required
    - `recording_timestamp` string, required: Timestamp relative to the start of the recording (HH:MM:SS).
    - `recording_playback_url` string, uri, required
    - `assignee` Assignee, required
      - `name` string, nullable, required
      - `email` string, email, nullable, required
      - `team` string, nullable, required
  - `highlights` Highlight[], nullable
    - `type` string, required: The label of the bookmark this highlight was created from.
    - `summary` string, nullable, required: A short summary of the highlighted moment.
    - `text` string: The full text of the highlight. Only present when it differs from `summary`.
    - `start_time` number, required: Start of the highlight, in seconds from the start of the recording.
    - `end_time` number, required: End of the highlight, in seconds from the start of the recording.
  - `calendar_invitees` Invitee[], required
    - `name` string, nullable, required
    - `matched_speaker_display_name` string, nullable: (When `include_transcript` is `true`) The display_name matching this email address. Null if no exact match found. Only available for meetings after Feb 1, 2025.
    - `email` string, email, nullable, required
    - `email_domain` string, nullable, required
    - `is_external` boolean, required
  - `recorded_by` FathomUser, required
    - `name` string, required
    - `email` string, email, required
    - `email_domain` string, required
    - `team` string, nullable, required
  - `crm_matches` CRMMatches, nullable: CRM data linked to the meeting. Only returns data from your or your team's linked CRM. If no CRM is connected for the workspace, the `error` field will be populated.
    - `contacts` CRMContactMatch[]
      - `name` string, required
      - `email` string, email, required
      - `record_url` string, uri, required
    - `companies` CRMCompanyMatch[]
      - `name` string, required
      - `record_url` string, uri, required
    - `deals` CRMDealMatch[]
      - `name` string, required
      - `amount` number, required: The amount in dollars.
      - `record_url` string, uri, required
    - `error` string, nullable

## Acknowledgement `200`

Return any 2xx code to acknowledge receipt.

---

[API](https://skmtc.dev/fathom/apis/fathom-external-api.md) - [All operations](https://skmtc.dev/fathom/apis/fathom-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fathom/apis/fathom-external-api/revisions/acb2fb1e3af8?raw)