Webhook

Delete webhook

DELETE/v4/config/platform/webhook/{webhookId}

Deletes a webhook. The service disables it and marks it as deleted: it receives no more events, a delivery that waits for its next attempt fails, and the other webhook operations no longer find it. Its payload URL is free for a new webhook. You cannot undo the delete.

The answer holds the webhook in its last state, with disabled true.

Delete webhook

Language of the request sample

curl -X DELETE 'https://demo-api.igrant.io/v4/config/platform/webhook/68a1f2c3d4e5f6a7b8c9d0e1' \
  -H 'Authorization: ApiKey <your-api-key>'

{
  "webhook": {
    "id": "6af08b9f38e8f33dcf79965f",
    "orgId": "6ae2bf741c3dadfeb27982ec",
    "payloadUrl": "https://example.com/webhooks/igrant",
    "contentType": "application/json",
    "subscribedEvents": {
      "consentManagementWebhook": [],
      "digitalWalletWebhook": [
        "ows.issuer.issuance_history.credential_issued",
        "ows.verifier.verification.presentation_received",
        "ows.holder.credential.received"
      ],
      "dataMarketplaceWebhook": []
    },
    "disabled": true,
    "secretKey": "<webhook-secret-key>",
    "skipSslVerification": false,
    "timestamp": "2026-11-08T14:47:59Z"
  }
}

Authorizations

Authorizationstringheaderrequired
Your API key with the prefix ApiKey: ApiKey <your-api-key>. Get an API key.
Scope:webhooks:delete

Path parameters

webhookIdstringrequired
The id of the webhook, from Create webhook or List all webhooks.
Example:"68a1f2c3d4e5f6a7b8c9d0e1"

Response

application/json

The deleted webhook.

webhookobject
The deleted webhook. disabled is always true.