Delete a webhook endpoint

curl --request DELETE \
  --url https://api.paystack.com/v1/notifications/webhooks/{id} \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Webhook endpoint deleted",
  "code": "ok",
  "data": null,
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Notification Webhooks

Delete a webhook endpoint

Delete a webhook endpoint. After deletion the endpoint stops receiving events and its signing secret is invalidated. Returns 404 if the endpoint does not exist in your integration.

The response envelope carries data: null on success.

Example

DELETE /v1/notifications/webhooks/whr_01HXYZABC1234567890ABCDEFG

DELETE

notifications

webhooks

{id}

Delete a webhook endpoint

curl --request DELETE \
  --url https://api.paystack.com/v1/notifications/webhooks/{id} \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Webhook endpoint deleted",
  "code": "ok",
  "data": null,
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Authorizations

Authorization

string

header

required

API key issued during merchant onboarding.

Path Parameters

string

required

Pattern: [^\/#\?]+?

Response

Webhook endpoint deleted

status

enum<boolean>

required

Available options:

true

Example:

true

message

string

required

Human-readable summary

Example:

"Webhook endpoint deleted"

code

enum<string>

required

Available options:

ok

Example:

"ok"

data

object

required

Example:

null