Update a webhook
Update webhook properties. Every field is optional, and an omitted field keeps its value.
To move the endpoint to a newer payload shape, set apiVersion. Every delivery after the change uses the new version, including retries of earlier events.
To replace the signing secret, use POST /api/v1/webhooks/:id/rotate-secret.
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 <= 255Body
application/json- body
Update webhook request
url?stringURL that will receive webhook events
urievents?array<>The event types to subscribe to. Replaces the current list
1 <= itemsenabled?booleanWhether this webhook is active
failureNotificationEmail?|Email address that will be notified if webhook delivery fails
^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$emailapiVersion?stringAPI version that determines the payload shape this endpoint receives. Set it to upgrade the endpoint to a newer payload shape
"2026-09""2026-10"Webhook 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 PATCH 'https://app.sajn.se/api/v1/webhooks/cm4k2x9p10013abcd1234efgh' \ -H 'Content-Type: application/json' \ -d '{ "events": [ "document.fully_signed", "document.completed", "document.rejected" ]}'{ "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", "document.rejected" ], "apiVersion": "2026-10", "createdAt": "2026-09-01T12:00:00.000Z", "updatedAt": "2026-09-01T12:00:00.000Z"}Was this page helpful?