create_webhook

Implementation Reference

• src/index.ts:398-416 (handler)

  MCP tool handler function for 'create_webhook'. Calls the Fathom client to create the webhook and returns a formatted markdown response with the webhook details including ID, URL, secret, and configuration.

  async ({ destination_url, include_transcript, include_summary, include_action_items, include_crm_matches, triggered_for }) => {
    console.error(`Creating webhook for ${destination_url}...`);
    
    const webhook = await fathom.createWebhook({
      destination_url,
      include_transcript,
      include_summary,
      include_action_items,
      include_crm_matches,
      triggered_for,
    });
  
    const markdown = `# Webhook Created Successfully\n\n| Field | Value |\n|-------|-------|\n| **ID** | ${webhook.id} |\n| **URL** | ${webhook.url} |\n| **Secret** | \`${webhook.secret}\` |\n| **Include Transcript** | ${webhook.include_transcript} |\n| **Include Summary** | ${webhook.include_summary} |\n| **Include Action Items** | ${webhook.include_action_items} |\n| **Include CRM Matches** | ${webhook.include_crm_matches} |\n| **Triggered For** | ${webhook.triggered_for.join(', ')} |\n\n**Important:** Save the webhook secret securely - you'll need it to verify incoming webhooks.`;
  
    console.error(`Webhook created: ${webhook.id}`);
    return {
      content: [{ type: 'text', text: markdown }],
    };
  }

• src/index.ts:388-417 (registration)

  Registers the 'create_webhook' tool with the MCP server using server.tool(), including Zod input schema and inline handler function.

  server.tool(
    'create_webhook',
    {
      destination_url: z.string().describe('URL to receive webhook events'),
      include_transcript: z.boolean().optional().describe('Include transcript in webhook payload'),
      include_summary: z.boolean().optional().describe('Include summary in webhook payload'),
      include_action_items: z.boolean().optional().describe('Include action items in webhook payload'),
      include_crm_matches: z.boolean().optional().describe('Include CRM matches in webhook payload'),
      triggered_for: z.array(z.enum(['my_recordings', 'shared_external_recordings', 'my_shared_with_team_recordings', 'shared_team_recordings'])).optional().describe('Which recordings trigger the webhook'),
    },
    async ({ destination_url, include_transcript, include_summary, include_action_items, include_crm_matches, triggered_for }) => {
      console.error(`Creating webhook for ${destination_url}...`);
      
      const webhook = await fathom.createWebhook({
        destination_url,
        include_transcript,
        include_summary,
        include_action_items,
        include_crm_matches,
        triggered_for,
      });
  
      const markdown = `# Webhook Created Successfully\n\n| Field | Value |\n|-------|-------|\n| **ID** | ${webhook.id} |\n| **URL** | ${webhook.url} |\n| **Secret** | \`${webhook.secret}\` |\n| **Include Transcript** | ${webhook.include_transcript} |\n| **Include Summary** | ${webhook.include_summary} |\n| **Include Action Items** | ${webhook.include_action_items} |\n| **Include CRM Matches** | ${webhook.include_crm_matches} |\n| **Triggered For** | ${webhook.triggered_for.join(', ')} |\n\n**Important:** Save the webhook secret securely - you'll need it to verify incoming webhooks.`;
  
      console.error(`Webhook created: ${webhook.id}`);
      return {
        content: [{ type: 'text', text: markdown }],
      };
    }
  );

• src/fathom-client.ts:160-167 (schema)

  TypeScript interface defining input parameters for creating a webhook, matching the MCP tool schema.

  export interface CreateWebhookParams {
    destination_url: string;
    include_transcript?: boolean;
    include_summary?: boolean;
    include_action_items?: boolean;
    include_crm_matches?: boolean;
    triggered_for?: ('my_recordings' | 'shared_external_recordings' | 'my_shared_with_team_recordings' | 'shared_team_recordings')[];
  }

• src/fathom-client.ts:313-318 (helper)

  FathomClient method that performs the actual API POST request to /webhooks to create the webhook, used by the MCP handler.

  async createWebhook(params: CreateWebhookParams): Promise<Webhook> {
    return this.request<Webhook>('/webhooks', {
      method: 'POST',
      body: JSON.stringify(params),
    });
  }

• src/index.ts:390-397 (schema)

  Zod schema for input validation of the 'create_webhook' MCP tool parameters.

  {
    destination_url: z.string().describe('URL to receive webhook events'),
    include_transcript: z.boolean().optional().describe('Include transcript in webhook payload'),
    include_summary: z.boolean().optional().describe('Include summary in webhook payload'),
    include_action_items: z.boolean().optional().describe('Include action items in webhook payload'),
    include_crm_matches: z.boolean().optional().describe('Include CRM matches in webhook payload'),
    triggered_for: z.array(z.enum(['my_recordings', 'shared_external_recordings', 'my_shared_with_team_recordings', 'shared_team_recordings'])).optional().describe('Which recordings trigger the webhook'),
  },