---
title: "Generate Webhook Secret"
method: POST
path: "/v3/webhook-secret"
tags: ["Webhooks"]
---

# Generate Webhook Secret

`POST /v3/webhook-secret`

**Generate a new webhook signing secret.**

Creates a new signing secret for this environment (or replaces the existing one).
The new secret is returned in full exactly once — store it securely.

After rotation all newly delivered webhooks will be signed with the new secret.
Update your verification logic before calling this endpoint if you need zero-downtime rotation.

## Response `200`

The request has succeeded.

- WebhookSecret — Webhook signing secret used to verify `bem-signature` headers on delivered webhooks.
  - `secret` string, required — The signing secret value. Store this securely — it is shown in full only on generation.

---

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