Rotate the webhook secret

POST

/api/did-monitoring/v1/webhook/rotate-secret

Makes a new signing secret and returns it one time. For 24 hours, CallerAPI signs each event with the new secret and with the old secret. Update your receiver in this time. After 24 hours, only the new secret signs.

INFO

Webhooks are not available on the Free plan.

Request

Authorization

Responses

🟢200OK

application/json

Bodyapplication/json

🟠401Unauthorized

🟠403Requires upgrade

🟠404Not found

🟠429Too many requests

🔴503Service unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.callerapi.com/api/did-monitoring/v1/webhook/rotate-secret'

Response Example

200 - New secret

{
    "status": "success",
    "data": {
        "url": "https://hooks.example.com/callerapi",
        "active": true,
        "secret": "whsec_REPLACE_WITH_YOUR_SECRET"
    }
}

Modified at 2026-10-29 10:41:34

Send a test event

Number flagged