v1

latestOpenAPI 3.0.02026-07-2482421001.1 KB

Webhooks

Configure webhook secret

This API configures the secret key for account-level webhook signature verification. Use this API 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.

🚧 We have a better version! This product is superseded by Org Level Webhooks, which we recommend for improved functionality and integration.

post/v1/account/settings/webhook/rotate-secret

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