---
title: "Create"
method: POST
path: "/api/v1/webhooks"
tags: ["Webhook"]
---

# Create

`POST /api/v1/webhooks`

Create a new webhook subscription to receive event notifications at the specified URL.

## Request body

- C1ApiWebhooksV1WebhooksServiceCreateRequest — The WebhooksServiceCreateRequest message.
  - `callbackTimeout` string, duration, nullable
  - `description` string — An optional description of the webhook's purpose.
  - `displayName` string, required — The human-readable name for the new webhook.
  - `url` string, required — The destination URL that will receive event notification HTTP callbacks.

## Response `200`

Successful response

- C1ApiWebhooksV1WebhooksServiceCreateResponse — The WebhooksServiceCreateResponse message.
  - `webhook` C1ApiWebhooksV1Webhook — The Webhook message.
    - `callbackTimeout` string, duration, nullable
    - `createdAt` string, date-time, nullable
    - `deletedAt` string, date-time, nullable
    - `description` string — An optional description of the webhook's purpose.
    - `displayName` string — The human-readable name of the webhook.
    - `id` string — The unique identifier of the webhook.
    - `updatedAt` string, date-time, nullable
    - `url` string — The destination URL that receives event notification HTTP callbacks.

## Changes

- **2026-08-21** `f2cf3228f366` — 2 breaking, 8 warning, 1 info
  - added `#/components/schemas/c1.api.webhooks.v1.Webhook, subschema #2` to the `webhook` response property `oneOf` list for the response status `200`
  - the `webhook` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `webhook/callbackTimeout` from the response with the `200` status
  - removed the optional property `webhook/createdAt` from the response with the `200` status
  - …7 more
- **2026-03-10** `7fa698b04b81` — 2 info
  - added the new optional request property `callbackTimeout`
  - added the optional property `webhook/callbackTimeout` to the response with the `200` status
- **2025-04-10** `17f9f3bcedd5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/webhooks/post.md)

---

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