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

# Create a webhook

`POST /webhooks`

Creates a new webhook. Name must be unique within the tenant.

## Request body

- CreateWebhookRequest
  - `name` string, required — Webhook name. Must be unique within the tenant.
  - `url` string, uri, required — HTTPS URL where event payloads will be delivered
  - `events` union[], required — List of event names to subscribe to. At least one event is required.
    - union
      - 'call_created' | 'call_summarized' | 'call_recording_deleted' | 'call_tag_added' | 'call_tag_removed' | 'call_transcribed' | 'call_transcript_deleted'
      - string

## Response `201`

Webhook created

- Webhook
  - `uuid` string, uuid, required — Webhook UUID
  - `name` string, required — Webhook name
  - `url` string, required — Webhook delivery URL
  - `events` union[], required — Subscribed event names
    - union
      - 'call_created' | 'call_summarized' | 'call_recording_deleted' | 'call_tag_added' | 'call_tag_removed' | 'call_transcribed' | 'call_transcript_deleted'
      - string
  - `createdOn` string, nullable, required — Creation timestamp in ISO 8601 format
  - `modifiedOn` string, nullable, required — Last modification timestamp in ISO 8601 format

## Other responses

- `401` — Authentication failed. The API key is missing or invalid.
- `409` — A webhook with this name already exists
- `429` — Rate limit exceeded. Retry after the X-RateLimit-Reset interval.

---

[API](https://skmtc.dev/modjo/apis/modjo-public-api.md) · [All operations](https://skmtc.dev/modjo/apis/modjo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/modjo/modjo-public-api/revisions/dcae8b3284e8/schema)