Skip to main content
POST
Replay failed deliveries of an endpoint

Authorizations

Authorization
string
header
required

Your API key in Authorization: Bearer <key>. Use vk_test_… keys against the sandbox and vk_live_… keys against production.

Headers

Idempotency-Key
string

Optional key (1-255 printable ASCII characters, no spaces; a UUID is ideal) that makes this POST safe to retry: the same key with the same request replays the stored response for 24 hours. See Idempotency.

Required string length: 1 - 255
Pattern: ^[\x21-\x7E]{1,255}$

Path Parameters

webhookEndpointId
integer<uint64>
required

Webhook endpoint id. Unsigned 64-bit integer (ids and large counters). May exceed 2^53; parse with a BigInt-safe JSON parser in JavaScript.

Required range: 0 <= x <= 18446744073709552000

Body

application/json

Window of events to replay.

since
string<date-time>
required

Start of the window (not older than 30 days).

Example:

"2026-11-01T00:00:00Z"

until
string<date-time>

End of the window (exclusive, default now).

Example:

"2026-11-01T00:00:00Z"

eventTypes
enum<string>[]

Only these types; absent means every type.

A consumer webhook type. Billing types (invoice-*, payment-failed, payment-method-deactivated) need view-consumer-billing, price-terms-* types need view-consumer-pricing. Treat as an open set: new values may be added.

Available options:
redemption-created,
redemption-voided,
redemption-entity-created,
redemption-link-exhausted,
redemption-link-expired,
catalog-voucher-set-available,
catalog-voucher-set-updated,
catalog-voucher-set-activation-scheduled,
catalog-voucher-set-activated,
catalog-voucher-set-deactivation-scheduled,
catalog-voucher-set-deactivated,
catalog-voucher-set-unavailable,
catalog-voucher-set-stock-low,
catalog-voucher-set-depleted,
webhook-endpoint-test,
invoice-finalised,
invoice-paid,
invoice-overdue,
invoice-voided,
payment-failed,
payment-method-deactivated,
price-terms-change-scheduled,
price-terms-acceptance-required,
price-terms-accepted

Response

OK

Single-object envelope around a WebhookReplayResult.

data
object
required

Result of a bulk replay.