---
title: "Add new webhook instance"
method: POST
path: "/webhooks"
tags: ["Webhooks"]
---

# Add new webhook instance

`POST /webhooks`

Returns the created webhook instance

## Request body

- WebhookInstancePostItem
  - `event` string, required
  - `url` string, required
  - `signingsecret` string, nullable
  - `integrationid` integer, nullable — Can be used to specify the integration code of a specific connector. This is mandatory in case you create a webhook related to a specific One API.

## Response `200`

Successful Response

- WebhookInstanceGetItem
  - `webhookid` string, uuid, required
  - `accountid` string, uuid, required
  - `createdby` string, uuid, nullable
  - `createdon` string, date-time, required
  - `event` string, required
  - `url` string, required
  - `status` 'active' | 'inactive', required
  - `integrationid` integer, nullable

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

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