---
title: "Create"
method: POST
path: "/v2/webhooks"
tags: ["V2Webhooks"]
---

# Create

`POST /v2/webhooks`

## Request body

- WebhookCreateRequest
  - `headers` string[]
  - `name` string, required
  - `description` string
  - `webhook_url` string, uri, required
  - `payload_format` 'json' | 'stringified_json' — An enumeration.

## Response `201`

Successful Response

- WebhookCreateResponse — This is base response model for all responses in partner service.
  - `webhook_id` string, required
  - `scope` WebhookScope, required
    - `type` 'tenant' | 'organization' | 'partner', required — An enumeration.
    - `id` string, required
  - `name` string, required
  - `description` string
  - `webhook_url` string, required
  - `headers` string[]
  - `payload_format` 'json' | 'stringified_json' — An enumeration.
  - `status` 'active' | 'disabled', required — An enumeration.
  - `created_at` string, date-time, required
  - `last_modified_time` string, date-time, required
  - `legacy` boolean
  - `response_context` V2ResponseContext, required
    - `correlation_id` string, required
    - `request_status` 'success' | 'miss' | 'failure', required — The `RequestStatus` class is an enumeration that defines the possible statuses of a request. This enum is used to indicate whether a request was successful, missed, or failed. It ensures consistent handling of request statuses across the application. Attributes: SUCCESS: Indicates that the request was successfully processed. MISS: Indicates that the request did not find any matching data. FAILURE: Indicates that the request encountered an error or failure.
    - `time_taken_in_seconds` number, required
  - `webhook_secret` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-31** `1b2d74e9de3d` — 1 breaking, 1 info
  - removed the required property `response_context/time_took_in_seconds` from the response with the `201` status
  - added the required property `response_context/time_taken_in_seconds` to the response with the `201` status
- **2026-08-27** `2d72469940e5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/explorium-ai/apis/partner-service/changes/v2/webhooks/post.md)

---

[API](https://skmtc.dev/explorium-ai/apis/partner-service.md) · [All operations](https://skmtc.dev/explorium-ai/apis/partner-service/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/explorium-ai/partner-service/revisions/1b2d74e9de3d/schema)