Webhooks

Rotate the signing secret

Issues a new signing secret. The old one stops working immediately.

POST
/v1/webhooks/{id}/rotate-secret

Issues a new signing secret. The old one stops working immediately.

Authorization

bearer
headerAuthorizationBearer <JWT>

Your secret API key: sk_live_… for live traffic or sk_test_… for testing.

Path Parameters

id*string

Response Body

The endpoint with its new secret.

application/json
Example Request
curl -X POST 'https://api.appstractone.com/v1/webhooks/string/rotate-secret'
Example Response
{
  "id": "whe_01M6MJSC366MMHPMM73ABCM5JA",
  "url": "https://example.com/webhooks/appstract",
  "events": [
    "message.delivered",
    "message.failed"
  ],
  "description": "Order notifications",
  "enabled": false,
  "createdAt": "2026-11-05T00:47:20.681Z",
  "updatedAt": "2026-11-05T00:47:20.723Z",
  "secret": "whsec_3f9c2b7e1d4a6f8b0c5e2d9a7b1f4c6e"
}