Send (replay) an event to the endpoint

curl --request POST \
  --url https://api.paystack.com/v1/notifications/webhooks/{id}/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "event_idempotency_key": "<string>"
}
'

{
  "status": true,
  "message": "Event queued for delivery",
  "code": "ok",
  "data": {
    "status": "accepted",
    "event_idempotency_key": "evt-1",
    "topic": "onramp.success"
  },
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Notification Webhooks

Send (replay) an event to the endpoint

Manually (re)send an existing event to this webhook endpoint. Identify the event by its event_idempotency_key (the id of an event already known to the system). The request is accepted for asynchronous delivery and the response echoes the queued event’s topic and status.

Use this to replay an event the endpoint missed — for example after fixing an outage on your receiver, or after activating an endpoint that should have received an earlier event.

Events are only delivered to active endpoints. Sending to an inactive endpoint returns 409 invalid_status ("… is inactive; reactivate it before sending.") — activate it with PATCH … { "active": true } first, then retry.

Body

event_idempotency_key — required. The idempotency key of the existing event to (re)deliver.

Example

POST /v1/notifications/webhooks/whr_01HXYZABC1234567890ABCDEFG/send
{
  "event_idempotency_key": "evt-1"
}

POST

notifications

webhooks

{id}

send

Send (replay) an event to the endpoint

curl --request POST \
  --url https://api.paystack.com/v1/notifications/webhooks/{id}/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "event_idempotency_key": "<string>"
}
'

{
  "status": true,
  "message": "Event queued for delivery",
  "code": "ok",
  "data": {
    "status": "accepted",
    "event_idempotency_key": "evt-1",
    "topic": "onramp.success"
  },
  "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: [^\/#\?]+?

Body

application/json

SendWebhookEventDto

event_idempotency_key

string

required

Required string length: 1 - 255

Response

Event queued for delivery

status

enum<boolean>

required

Available options:

true

Example:

true

message

string

required

Human-readable summary

Example:

"Event queued for delivery"

code

enum<string>

required

Available options:

ok

Example:

"ok"

data

object

required

Show child attributes