Webhooks

Rotate the signing secret

Changed on Sep 30, 2026

During the grace window (default 24 h, max 168, 0 = immediate) deliveries are signed with both secrets.

post/webhooks/{id}/rotate-secret

Request

Base URL
https://api.poststack.dev
Auth
- HTTP bearer
- or OAuth 2
  Authorization codehttps://poststack.dev/oauth/authorize
  Token URLhttps://poststack.dev/oauth/token
TypeScript
https://skmtc.dev/poststack/apis/poststack-api/docs/webhooks/:id/rotate-secret/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idinteger required

Webhook numeric id.

Request body

graceHoursinteger

Response

Rotated. The new signingSecret is shown only here.

signingSecretstring required

Plaintext signing secret — shown once. Verify X-PostStack-Signature with it.

Changes

Sep 30, 20264dc1e20989c8 Revision changes
- warning
  added the new daily_limit_exceeded enum value to the //// response property for the response status
- warning
  added the new daily_limit_exceeded enum value to the response property for the response status
- warning
  added the new daily_limit_exceeded enum value to the response property for the response status
- warning
  added the new daily_limit_exceeded enum value to the response property for the response status
- warning
  added the new daily_limit_exceeded enum value to the response property for the response status
- warning
  added the new monthly_limit_exceeded enum value to the //// response property for the response status
- warning
  added the new monthly_limit_exceeded enum value to the response property for the response status
- warning
  added the new monthly_limit_exceeded enum value to the response property for the response status
- warning
  added the new monthly_limit_exceeded enum value to the response property for the response status
- warning
  added the new monthly_limit_exceeded enum value to the response property for the response status
- warning
  added the new send_limit_exceeded enum value to the //// response property for the response status
- warning
  added the new send_limit_exceeded enum value to the response property for the response status
- warning
  added the new send_limit_exceeded enum value to the response property for the response status
- warning
  added the new send_limit_exceeded enum value to the response property for the response status
- warning
  added the new send_limit_exceeded enum value to the response property for the response status
Sep 29, 2026ef5b22b98333 Revision changes
- info
  endpoint added

Operation history