---
title: "Webhook Create"
method: POST
path: "/webhook/decoda/create"
tags: ["webhook"]
---

# Webhook Create

`POST /webhook/decoda/create`

Create a new `Webhook` for the `Tenant`

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Request body

- WebhookCreate
  - `subscriptions` AlertType[], required — List of event types the webhook subscribes to.
  - `url` string, required — The URL where the webhook will send notifications.
  - `notificationEmail` string, nullable — Email address for sending notifications about delivery failures.

## Response `200`

Successful Response

- WebhookSummary
  - `id` string, required — Unique identifier for the webhook.
  - `subscriptions` AlertType[], required — List of event types the webhook is subscribed to.
  - `url` string, required — The URL where the webhook sends notifications.
  - `createdDate` string, date-time, required — The date and time when the webhook was created.
  - `updatedDate` string, date-time, nullable — The date and time when the webhook was last updated.
  - `secret` string, required — The secret key used for signing the webhook payloads.
  - `notificationEmail` string, nullable — Email address for sending notifications about delivery failures.
  - `isArchived` boolean — Whether the webhook has been archived.

## Other responses

- `422` — Validation Error

---

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