Sign in

v1

latestOpenAPI 3.0.02026-07-2482421001.1 KB
Org Level Webhooks

Configure webhook secret

This API configures the secret key for a specific org-level webhook. Use this endpoint to add a new secret or update an existing one. The secret is used to sign webhook payloads using HMAC SHA256, allowing you to verify that requests originate from Ocrolus.

post/webhook/{webhook_uuid}/rotate-secret

Path parameters

webhook_uuidstring uuid required

The unique identifier of the webhook.

Request body

secret_keystring required

The new webhook secret key. Must be between 16 and 128 characters long.

Example request

{
  "secret_key": "sample_secret_1230ab"
}

Response

Success