---
title: "Create a webhook"
method: POST
path: "/webhooks"
tags: ["Webhooks"]
---

# Create a webhook

`POST /webhooks`

Create a webhook to receive new meeting content.
At least one of `include_transcript`, `include_crm_matches`, `include_summary`, or `include_action_items` must be true.

## Request body

- object
  - `destination_url` string, uri, required — The URL to send the webhook to.
  - `include_action_items` boolean — Include the action items for each meeting.
  - `include_crm_matches` boolean — Include CRM matches for each meeting. Only returns data from your or your team's linked CRM.
  - `include_summary` boolean — Include the summary for each meeting.
  - `include_transcript` boolean — Include the transcript for each meeting.
  - `triggered_for` string[], required — You must send at least one of the following types of recordings to trigger on. - `my_recordings`: Your private recordings, as well as those you've shared with individuals. (On Team Plans, this excludes recordings you've shared with any teams.) - `shared_external_recordings`: Recordings shared with you by other users. (For Team Plans, this does not include recordings shared by other users on your Team Plan.) - `my_shared_with_team_recordings`: (Team Plans only). All recordings that you have shared with other teams (e.g. Marketing or Sales). Recordings you've shared with individuals but not with teams are not included. - `shared_team_recordings`: (Team Plans only) All recordings you can access from other users on your Team Plan, whether shared with you individually or with your team.

## Response `201`

The created webhook.

- Webhook
  - `id` string, required
  - `url` string, uri, required
  - `secret` string, required — The secret used to verify the webhook signature.
  - `created_at` string, date-time, required — The date and time the webhook was created in ISO 8601 format.
  - `include_transcript` boolean, required
  - `include_crm_matches` boolean, required
  - `include_summary` boolean, required
  - `include_action_items` boolean, required
  - `triggered_for` string[], required

## Other responses

- `400` — Bad request - the query parameters were invalid.
- `401` — Unauthorized - missing or invalid `Authorization` header.
- `429` — Rate limited - you have exceeded the rate limit for the requested endpoint. Check our [rate limiting](/api-reference#rate-limiting) documentation for more information.

---

[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-service-production.skmtc.workers.dev/v1/apis/fathom/fathom-external-api/revisions/454c25378beb/schema)