Recomly APIEndpointsIntegrationsWebhook Keys
Revoke webhook key
Revoke an inbound webhook signing key.
DELETE /api/app/integrations/webhook-keys/{keyId}
Permanently revokes a webhook signing key. Any inbound webhook requests signed with the revoked key will immediately begin failing signature verification. Requires the admin role.
Request
See API Basics for required headers.
Path parameters
| Parameter | Type | Description |
|---|---|---|
keyId | string | The ID of the webhook key to revoke. |
Sample request
curl -X DELETE https://api.recomly.com/api/app/integrations/webhook-keys/wk_a1b2c3d4e5f6 \
-H "Authorization: Bearer rk_live_abc123:def456"Sample response
Status: 200 OK
{
"ok": true
}Error responses
See API Basics for standard status codes and error response format.
| Status | Meaning |
|---|---|
403 | Caller does not have the admin role, or the integrations feature is not enabled. |
404 | No webhook key with that ID exists in the organization. |