---
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

> 33 revisions in range; 1 could not be searched.

- **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)