---
title: "Create a new Webhook"
method: POST
path: "/orgs/{orgId}/apps/{appId}/webhooks"
tags: ["public", "Event"]
---

# Create a new Webhook

`POST /orgs/{orgId}/apps/{appId}/webhooks`

## Path parameters

- `orgId` string, required
- `appId` string, required

## Request body

- WebhookRequest — Webhook is a special type of a Job. It performs an HTTPS request to a specified URL with specified headers.
  - `disabled` boolean, nullable — Defines whether this job is currently disabled.
  - `headers` JSONFieldRequest
  - `id` string — Job ID, unique within the Organization
  - `payload` JSONFieldRequest
  - `triggers` EventBaseRequest[] — A list of Events by which the Job is triggered
    - `scope` string — Event scope
    - `type` string — Event type
  - `url` string, nullable — The webhook's URL (without protocol, only HTTPS is supported).

## Response `201`

A created webhook.

- WebhookResponse — Webhook is a special type of a Job. It performs an HTTPS request to a specified URL with specified headers.
  - `created_at` string — The timestamp of when this Job was created.
  - `created_by` string — The user who created this Job
  - `disabled` boolean, nullable, required — Defines whether this job is currently disabled.
  - `headers` JSONFieldResponse, required
  - `id` string, required — Job ID, unique within the Organization
  - `payload` JSONFieldResponse, required
  - `triggers` EventBaseResponse[], required — A list of Events by which the Job is triggered
    - `scope` string, required — Event scope
    - `type` string, required — Event type
  - `url` string, nullable, required — The webhook's URL (without protocol, only HTTPS is supported).

## Other responses

- `400` — Some of the values supplied are invalid.
- `409` — The supplied `id` clashes with an existing Job.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)