fathom_create_webhook
Create a webhook to receive real-time notifications when Fathom meetings are processed, automatically posting meeting data to your specified URL.
Instructions
Create a webhook to receive real-time notifications when meetings are processed in Fathom.
This tool creates a webhook subscription that will POST meeting data to your specified URL whenever new meeting content becomes available.
Args:
destination_url (string, required): The URL to receive webhook notifications
triggered_for (string[], required): At least one trigger type:
'my_recordings': Your private recordings and those shared with individuals
'shared_external_recordings': Recordings shared with you by external users
'my_shared_with_team_recordings': Your recordings shared with teams
'shared_team_recordings': Team recordings accessible to you
include_action_items (boolean): Include action items in payload (default: false)
include_crm_matches (boolean): Include CRM matches in payload (default: false)
include_summary (boolean): Include meeting summary in payload (default: false)
include_transcript (boolean): Include transcript in payload (default: false)
Returns: The created webhook details including:
id: Webhook ID (use this for deletion)
url: Destination URL
secret: Webhook secret for signature verification
created_at: Creation timestamp
Examples:
Basic webhook: { destination_url: 'https://your-app.com/webhook', triggered_for: ['my_recordings'] }
With all content: { destination_url: 'https://your-app.com/webhook', triggered_for: ['my_recordings', 'shared_team_recordings'], include_transcript: true, include_summary: true, include_action_items: true }
Notes:
Webhooks use HMAC-SHA256 signatures for verification
The secret is only shown once upon creation - save it securely
Webhooks must return 2xx status to acknowledge receipt
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| destination_url | Yes | The URL to receive webhook notifications | |
| triggered_for | Yes | Types of recordings that trigger the webhook: 'my_recordings', 'shared_external_recordings', 'my_shared_with_team_recordings', 'shared_team_recordings' | |
| include_action_items | No | Include action items in webhook payload | |
| include_crm_matches | No | Include CRM matches in webhook payload | |
| include_summary | No | Include meeting summary in webhook payload | |
| include_transcript | No | Include transcript in webhook payload |