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

# Create a webhook

`POST /apps/{clientId}/webhooks`

## Path parameters

- `clientId` string, required — The application identifier

## Request body

- CreateWebhookRequest
  - `url` string, required — The url of the webhook target.
  - `events` string[], required — The list of events to subscribe.
  - `name` string, required — The name of the webhook.
  - `description` string — The description of the webhook.

## Response `201`

The created webhook

- WebhookResponse
  - `id` string — The identifier of the webhook
  - `clientId` string — The identifier of the application
  - `url` string — The target URL of the webhook
  - `name` string — Name of the webhook
  - `description` string — Description of the webhook
  - `events` string[] — The list of event types to trigger webhook instantiation
  - `enabled` boolean — The state of the webhook
  - `creationTime` string, date-time — The creation timestamp of the webhook
  - `lastUpdatedTime` string, date-time — The last updated timestamp of the webhook

## Other responses

- `400` — Missing required fields
- `404` — The application or the webhook does not exist

---

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