POST https://xquik.com/api/v1/webhooks/{id}/resume
Free. This endpoint does not consume credits.
delivery_status,
consecutive_failures, failure_hard_cap, status_code, and the delivery-log
endpoint beside the webhook ID.
Path parameters
Headers
What happens
Xquik sends a signedwebhook.test request to the webhook URL. If your receiver
returns a 2xx status, Xquik reactivates the webhook. It resets consecutiveFailures to 0 and returns the updated webhook object.
Xquik then starts sending waiting deliveries at once. This includes failed
deliveries and ones that waited when you paused the webhook. A paused webhook
holds each waiting delivery until its 7 days end. Events expire 30 days after Xquik
creates them.
Events that happen during a pause may never arrive. To catch up, page through
List Events.
If the signed test fails, Xquik returns 400 with success: false,
statusCode, and error. Xquik does not reactivate the webhook.
This endpoint does not rotate or return the signing secret. Keep using the
one-time secret from Create Webhook.Response
200 OK
400 Test failed
{ "success": false, "statusCode": 500, "error": "HTTP 500" }
Fix the receiver, then retry this endpoint.400 Invalid request
{ "error": "invalid_id", "message": "Invalid webhook ID format" }
The provided webhook ID is not a valid format.401 Unauthenticated
{ "error": "unauthenticated", "message": "Missing or invalid API key" }
Missing or invalid API key or session cookie.404 Not found
{ "error": "not_found", "message": "Webhook not found" }
No webhook exists with this ID, or it belongs to a different account.429 Rate limited
Too many requests. Wait for theRetry-After header before retrying.Recovery handoff
Use this endpoint to reactivate a webhook you paused. Also use it after you fix a failing receiver. Xquik sends a signed test first, then starts sending waiting deliveries at once.Needs attention
deliveryStatus: "needs_attention" means 200 failed checks in a row. Each
check retries 1 real waiting delivery. Delivery continues. After you fix
the receiver, call Resume to start sending at once.Signed test required
Resume succeeds only after your receiver answers a signed
webhook.test request with 2xx.Failure counter
Store
consecutiveFailures and failureHardCap for alerting and recovery
dashboards.No secret rotation
Resume does not return or rotate
secret. Keep verifying delivery
signatures with the secret returned at creation time.Delivery log
After resuming, check
List Deliveries for recent
status,
attempts, lastStatusCode, and lastError rows.Event replay
Use delivery
streamEventId with Get Event or
event list pages to backfill missed work.This endpoint accepts 2 auth methods. Send an API key in the
x-api-key header. Or send a session cookie from the dashboard.Related. List Webhooks · Update Webhook · Test Webhook · List Deliveries · Webhook VerificationResponse examples
- 400
{ "error": "Connection timed out" } - 401
{ "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." } - 403
{ "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." } - 404
{ "error": "not_found", "message": "Resource not found." } - 429
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }