Skip to Content

Issue a new signing secret

Needs the scope webhooks:manage

Issue a new signing secret. The old one stays valid for 24 hours, and every delivery in that time carries a signature for each secret, so you can switch without missing an event.

Path Parameters

webhook_id*string

The id from POST /api/v1/webhooks.

Formatuuid

Response Body

OK

application/json
  1. response
id*string
Formatuuid
secret*string

The new secret, whsec_ followed by 43 characters. Shown once.

secretPrefix*string
previousSecretValidUntil*string

The old secret keeps signing for 24 hours; the header carries both signatures in that time.

Formatdate-time
Example Request
curl -sS -X POST https://platform.charpstar.co/api/v1/webhooks/$WEBHOOK_ID/rotate-secret \  -H "Authorization: Bearer $CHARPSTAR_API_KEY"
Example Response
{  "id": "a1b2c3d4-0000-4000-8000-000000000001",  "secret": "whsec_Zq7xL2mN9pR4sT6uV8wX0yA1bC3dE5fG7hJ9kL2mN4p",  "secretPrefix": "whsec_Zq7xL2",  "previousSecretValidUntil": "2026-10-21T09:31:00.000Z"}