---
title: "Rotate webhook signing secret"
method: POST
path: "/api/v1/bila/webhooks/{id}/rotate-secret"
tags: ["Webhooks"]
---

# Rotate webhook signing secret

`POST /api/v1/bila/webhooks/{id}/rotate-secret`

## Request

- Base URL: `https://api.usebila.com`
- URL: `https://api.usebila.com/api/v1/bila/webhooks/{id}/rotate-secret`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/bilasdk/apis/bila-payment-gateway-api/docs/api/v1/bila/webhooks/:id/rotate-secret/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required

## Response `200`

Secret rotated

- object
  - `status` boolean, required: Request success status
  - `message` string, required: Response message
  - `data` RotateWebhookSecretResultDto
    - `secret` string, required: New signing secret (64-character hex, shown once)

---

[API](https://skmtc.dev/bilasdk/apis/bila-payment-gateway-api.md) - [All operations](https://skmtc.dev/bilasdk/apis/bila-payment-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bilasdk/apis/bila-payment-gateway-api/revisions/781041632c91?raw)