Skip to main content
POST https://xquik.com/api/v1/webhooks/{id}/resume
Free. This endpoint does not consume credits.
These snippets build a recovery row. Store 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 signed webhook.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 the Retry-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 Verification

Response 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 }