SafeWeb
Distributor API

Get distributor webhook endpoint

GET
/api/v1/distributors/webhooks/{webhookId}

Path Parameters

webhookId*string
Formatuuid

Header Parameters

SW-DISTRIBUTOR-ID*string
SW-API-KEY*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/distributors/webhooks/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "SW-DISTRIBUTOR-ID: string" \  -H "SW-API-KEY: string"
{  "success": true,  "webhook": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "url": "http://example.com",    "eventTypes": [      "string"    ],    "enabled": true,    "maxAttempts": 1,    "createdAt": "2019-08-24T14:15:22Z"  }}

Create distributor webhook endpoint POST

Registers a new HTTPS webhook URL for the authenticated distributor scope. Provide `url`, at least one `eventTypes` value (canonical names such as customer.breach.found), and optionally `enabled` and `maxAttempts` (1–3). Signing secrets are managed separately under webhook secrets.

Update distributor webhook endpoint PATCH

Updates one or more fields on an existing distributor-scoped webhook endpoint. Include at least one of `url`, `eventTypes`, `enabled`, or `maxAttempts`.