---
title: "Create Webhook Key"
method: POST
path: "/v1/webhook-keys"
tags: ["webhook-security"]
---

# Create Webhook Key

`POST /v1/webhook-keys`

## Request

- Base URL: `https://api.forgeorbital.com`
- URL: `https://api.forgeorbital.com/v1/webhook-keys`
- Auth: HTTP bearer

## Request body

- WebhookKeyCreateRequest
  - `description` string, nullable

## Response `201`

Successful Response

- WebhookKeyCreateResponse
  - `schema_version` 'forge-product-webhook-key/v2', required
  - `key_id` string, required
  - `secret_b64` string, required
  - `description` string, nullable, required
  - `lifecycle_status` 'active' | 'pending', required
  - `created_at` string, required
  - `warning` string, required

## Other responses

- `422`: Stable, sanitized product API error.
- `default`: Stable, sanitized product API error.

---

[API](https://skmtc.dev/forgeorbital/apis/forge-decision-records-api.md) · [All operations](https://skmtc.dev/forgeorbital/apis/forge-decision-records-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forgeorbital/apis/forge-decision-records-api/revisions/4410e0e5c86a?raw)