SafeWeb API
Partner API

Cycle webhook signing secret

POST
/api/v1/integrations/webhooks/secrets/cycle

Header Parameters

SW-PARTNER-ID*string
SW-API-KEY*string

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/integrations/webhooks/secrets/cycle" \  -H "SW-PARTNER-ID: string" \  -H "SW-API-KEY: string"
{
  "success": true,
  "secret": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "token": "string"
  }
}
{
  "success": false,
  "error": "string"
}
{
  "success": false,
  "error": "string"
}
{
  "success": false,
  "error": "string"
}

Generate webhook signing secret POST

Creates a new active signing secret for the authenticated partner organization when none exists. The token is returned once; store it securely and use it to verify `X-Signature` on deliveries. There is no request body.

Deactivate webhook signing secret DELETE

Deactivates an active or fallback signing secret by id for the authenticated partner organization.