---
title: "Changes to Create a webhook (secret returned once)"
method: POST
path: "/v1/orgs/{orgId}/webhooks/create"
---

# Changes to Create a webhook (secret returned once)

`POST /v1/orgs/{orgId}/webhooks/create`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 64 revisions.

- **2026-10-26** `7fe59d94a9f5`: 3 info
- **2026-10-25** `9685c770a682`: 3 info
- **2026-10-21** `dc9750cb25b5`: 1 breaking, 10 info
- **2026-10-10** `12b2fcbcc298`: 9 info

## Changes

- **2026-10-26** `7fe59d94a9f5`: 3 info
  - added the optional property `requestId` to the response with the `400` status
  - added the optional property `requestId` to the response with the `401` status
  - added the optional property `requestId` to the response with the `403` status
- **2026-10-25** `9685c770a682`: 3 info
  - added the new `endpoint.deleted` enum value to the request property `events/items/`
  - added the new `endpoint.disabled` enum value to the request property `events/items/`
  - added the new `endpoint.ready` enum value to the request property `events/items/`
- **2026-10-21** `dc9750cb25b5`: 1 breaking, 10 info
  - request property `events/items/` was restricted to a list of enum values
  - added the new `balance.depleted` enum value to the request property `events/items/`
  - added the new `balance.low` enum value to the request property `events/items/`
  - added the new `batch.cancelled` enum value to the request property `events/items/`
  - added the new `batch.completed` enum value to the request property `events/items/`
  - added the new `batch.expired` enum value to the request property `events/items/`
  - added the new `batch.failed` enum value to the request property `events/items/`
  - added the new `vm.interrupted` enum value to the request property `events/items/`
  - added the new `vm.running` enum value to the request property `events/items/`
  - added the new `vm.stopped` enum value to the request property `events/items/`
  - added the new `vm.terminated` enum value to the request property `events/items/`
- **2026-10-10** `12b2fcbcc298`: 9 info
  - added the optional property `deniedBy` to the response with the `400` status
  - added the optional property `deniedBy` to the response with the `401` status
  - added the optional property `deniedBy` to the response with the `403` status
  - added the optional property `permission` to the response with the `400` status
  - added the optional property `permission` to the response with the `401` status
  - added the optional property `permission` to the response with the `403` status
  - added the optional property `policies` to the response with the `400` status
  - added the optional property `policies` to the response with the `401` status
  - added the optional property `policies` to the response with the `403` status

---

[Operation](https://skmtc.dev/openrelay/apis/openrelay-api/docs/v1/orgs/:orgId/webhooks/create/post.md) - [API](https://skmtc.dev/openrelay/apis/openrelay-api.md) - [Page](https://skmtc.dev/openrelay/apis/openrelay-api/changes/v1/orgs/:orgId/webhooks/create/post)