---
title: "Rotate a webhook's secret"
method: POST
path: "/webhooks/{webhookId}/rotate-secret"
tags: ["Webhooks"]
---

# Rotate a webhook's secret

`POST /webhooks/{webhookId}/rotate-secret`

## Request

- Base URL: `https://api.mockflow.com/v1`
- URL: `https://api.mockflow.com/v1/webhooks/{webhookId}/rotate-secret`
- Auth: HTTP bearer

A new signing secret, effective for the next delivery. Update your receiver first.

## Response `200`

OK

- object
  - `id` string
  - `secret` string

## Other responses

- `429`: Too many requests.
- `4XX`: An error. See the envelope and the code list on the Errors page.

---

[API](https://skmtc.dev/mockflow/apis/mockflow-boards-api.md) - [All operations](https://skmtc.dev/mockflow/apis/mockflow-boards-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mockflow/apis/mockflow-boards-api/revisions/1a890390518c?raw)