Rotate a webhook's signing secret
Generates a new signing secret and returns the webhook with it in secret. Store it: no other response returns it.
For 24 hours, every delivery carries two signatures in webhook-signature, one per secret, so you can deploy the new secret without dropping deliveries. A Standard Webhooks library accepts a request when any signature matches. After 24 hours, only the new secret signs.
Plan Requirement: Requires the Team plan or higher, or a sandbox organization.
AuthorizationBearer <token>API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.
id*stringThe webhook ID.
Sajn-Version?stringAPI version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.
"2026-09""2026-10"Sajn-Workspace?stringID of the workspace this request acts in, from GET /api/v1/workspaces. Without it, an API key acts in its default workspace. The token's user must be a member of the workspace; an OAuth token only accepts the workspace it was granted for. A workspace that doesn't exist or can't be reached returns 403 WORKSPACE_ACCESS_DENIED.
Idempotency-Key?stringMakes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.
length <= 255Webhook response
application/json- response
Webhook response
id*stringUnique webhook identifier
url*stringURL that receives webhook events
secret?stringSigning secret for this endpoint, in the Standard Webhooks format whsec_<base64>. Returned only when you create the webhook and when you rotate the secret, so store it then.
enabled*booleanWhether this webhook is active
status*stringDISABLED when enabled is false. PAUSED when sajn stopped delivering because the endpoint failed for three days or answered 410 Gone; resume with POST /api/v1/webhooks/:id/reactivate.
"ENABLED""DISABLED""PAUSED"pausedAt*|When sajn paused the webhook. Null unless status is PAUSED.
date-timepauseReason*|Why sajn paused the webhook: HTTP_<status code> for the last answer, such as HTTP_410, or NETWORK_ERROR. Null unless status is PAUSED.
failureNotificationEmail*|Email address that receives a notification if webhook delivery fails
events*array<>The event types this webhook subscribes to
apiVersion*stringAPI version, in YYYY-MM format, that determines the payload shape this endpoint receives
createdAt*stringDate and time when webhook was created
date-timeupdatedAt*stringDate and time when webhook was last updated
date-timecurl -X POST 'https://app.sajn.se/api/v1/webhooks/cm4k2x9p10013abcd1234efgh/rotate-secret'{ "id": "cm4k2x9p10013abcd1234efgh", "url": "https://example.com/webhooks/sajn", "enabled": true, "status": "ENABLED", "pausedAt": null, "pauseReason": null, "failureNotificationEmail": "dev@example.com", "events": [ "document.fully_signed", "document.completed" ], "apiVersion": "2026-10", "createdAt": "2026-09-01T12:00:00.000Z", "updatedAt": "2026-09-01T12:00:00.000Z", "secret": "whsec_c2Fqbi1leGFtcGxlLXdlYmhvb2stc2VjcmV0LTAwNDI="}Was this page helpful?