Resume Twitter webhook deliveries & retry events

{
  "success": true,
  "statusCode": 200,
  "webhook": {
    "id": "42",
    "url": "https://example.com/webhook",
    "eventTypes": [
      "tweet.new"
    ],
    "isActive": true,
    "consecutiveFailures": 0
  }
}

{
  "error": "Connection timed out"
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

POST

webhooks

{id}

resume

Resume Twitter webhook deliveries & retry events

curl --request POST \
  --url https://xquik.com/api/v1/webhooks/{id}/resume \
  --header 'x-api-key: <api-key>'

const options = {method: 'POST', headers: {'x-api-key': '<api-key>'}};

fetch('https://xquik.com/api/v1/webhooks/{id}/resume', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/webhooks/{id}/resume"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "success": true,
  "statusCode": 123,
  "webhook": {
    "id": "<string>",
    "url": "<string>",
    "eventTypes": [
      "<string>"
    ],
    "isActive": true,
    "consecutiveFailures": 123,
    "deliveryStatus": "<string>",
    "failureHardCap": 123,
    "createdAt": "<string>"
  },
  "error": "<string>"
}

Free. This endpoint does not consume credits.

curl -X POST https://xquik.com/api/v1/webhooks/15/resume \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  | jq '{
    webhook_id: .webhook.id,
    resumed: (.success == true),
    status_code: .statusCode,
    delivery_status: .webhook.deliveryStatus,
    consecutive_failures: .webhook.consecutiveFailures,
    failure_hard_cap: .webhook.failureHardCap,
    test_endpoint: ("/api/v1/webhooks/" + .webhook.id + "/test"),
    deliveries_endpoint: ("/api/v1/webhooks/" + .webhook.id + "/deliveries")
  }'

const response = await fetch("https://xquik.com/api/v1/webhooks/15/resume", {
  method: "POST",
  headers: { "x-api-key": "xq_YOUR_KEY_HERE" },
});
const result = await response.json();
const resumeHandoff = {
  webhook_id: result.webhook.id,
  resumed: result.success === true,
  status_code: result.statusCode,
  delivery_status: result.webhook.deliveryStatus,
  consecutive_failures: result.webhook.consecutiveFailures,
  failure_hard_cap: result.webhook.failureHardCap,
  test_endpoint: `/api/v1/webhooks/${result.webhook.id}/test`,
  deliveries_endpoint: `/api/v1/webhooks/${result.webhook.id}/deliveries`,
};

import requests

response = requests.post(
    "https://xquik.com/api/v1/webhooks/15/resume",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
)
result = response.json()
webhook = result["webhook"]
resume_handoff = {
    "webhook_id": webhook["id"],
    "resumed": result["success"] is True,
    "status_code": result["statusCode"],
    "delivery_status": webhook["deliveryStatus"],
    "consecutive_failures": webhook["consecutiveFailures"],
    "failure_hard_cap": webhook["failureHardCap"],
    "test_endpoint": f"/api/v1/webhooks/{webhook['id']}/test",
    "deliveries_endpoint": f"/api/v1/webhooks/{webhook['id']}/deliveries",
}

package main

import (
  "encoding/json"
  "log"
  "net/http"
)

type Webhook struct {
  ConsecutiveFailures int      `json:"consecutiveFailures"`
  CreatedAt           string   `json:"createdAt"`
  DeliveryStatus      string   `json:"deliveryStatus"`
  EventTypes          []string `json:"eventTypes"`
  FailureHardCap      int      `json:"failureHardCap"`
  ID                  string   `json:"id"`
  IsActive            bool     `json:"isActive"`
  URL                 string   `json:"url"`
}

type ResumeResponse struct {
  StatusCode int     `json:"statusCode"`
  Success    bool    `json:"success"`
  Webhook    Webhook `json:"webhook"`
}

type ResumeHandoff struct {
  ConsecutiveFailures int    `json:"consecutive_failures"`
  DeliveriesEndpoint  string `json:"deliveries_endpoint"`
  DeliveryStatus      string `json:"delivery_status"`
  FailureHardCap      int    `json:"failure_hard_cap"`
  Resumed             bool   `json:"resumed"`
  StatusCode          int    `json:"status_code"`
  TestEndpoint        string `json:"test_endpoint"`
  WebhookID           string `json:"webhook_id"`
}

func main() {
  req, err := http.NewRequest("POST", "https://xquik.com/api/v1/webhooks/15/resume", nil)
  if err != nil {
    log.Fatal(err)
  }
  req.Header.Set("x-api-key", "xq_YOUR_KEY_HERE")

  resp, err := http.DefaultClient.Do(req)
  if err != nil {
    log.Fatal(err)
  }
  defer resp.Body.Close()

  var result ResumeResponse
  if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
    log.Fatal(err)
  }
  handoff := ResumeHandoff{
    ConsecutiveFailures: result.Webhook.ConsecutiveFailures,
    DeliveriesEndpoint:  "/api/v1/webhooks/" + result.Webhook.ID + "/deliveries",
    DeliveryStatus:      result.Webhook.DeliveryStatus,
    FailureHardCap:      result.Webhook.FailureHardCap,
    Resumed:             result.Success,
    StatusCode:          result.StatusCode,
    TestEndpoint:        "/api/v1/webhooks/" + result.Webhook.ID + "/test",
    WebhookID:           result.Webhook.ID,
  }
  _ = handoff
}

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

string

required

The webhook ID to test and resume.

Headers

string

required

Your API key. This endpoint also accepts session cookie authentication.

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 keeps waiting deliveries until you resume. 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.

Webhook resume check	Response source	Recovery rule
Signed test result	`success`	Resume only when this value is `true`.
Receiver status	`statusCode`	Require a `2xx` response.
Webhook ID	`webhook.id`	Match the receiver you are recovering.
Delivery URL	`webhook.url`	Confirm the repaired HTTPS endpoint.
Event filter	`webhook.eventTypes`	Confirm the filter still covers your monitor event types.
Active state	`webhook.isActive`	Expect `true` after recovery.
Failure count	`webhook.consecutiveFailures`	Expect `0` after recovery.
Delivery state	`webhook.deliveryStatus`	Expect `active` after recovery.

Response

200 OK

boolean

true when the signed test request succeeded and Xquik resumed the webhook.

number

HTTP status code returned by your receiver during the signed test.

object

Updated webhook configuration. Webhook object fields.

string

Unique webhook identifier.

string

Delivery endpoint URL.

string[]

Event types this webhook subscribes to.

boolean

true after a successful resume.

number

Consecutive receiver failures. Resets to 0 after a successful resume.

string

active, paused, or needs_attention.

number

Failure count that sets needs_attention. Delivery continues past it.

string

ISO 8601 creation timestamp.

{
  "success": true,
  "statusCode": 200,
  "webhook": {
    "id": "15",
    "url": "https://your-server.com/webhook",
    "eventTypes": ["tweet.new", "tweet.reply"],
    "isActive": true,
    "consecutiveFailures": 0,
    "deliveryStatus": "active",
    "failureHardCap": 200,
    "createdAt": "2026-02-24T10:30:00.000Z"
  }
}

400 Test failed

boolean

false when the signed test did not receive a 2xx response.

number

HTTP status code from the receiver, or 0 if it was unreachable.

string

Delivery failure reason.

{
  "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

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

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 a 2xx response.

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 a session cookie from the dashboard.Related. List Webhooks · Update Webhook · Test Webhook · List Deliveries · Webhook Verification

{
  "success": true,
  "statusCode": 200,
  "webhook": {
    "id": "42",
    "url": "https://example.com/webhook",
    "eventTypes": [
      "tweet.new"
    ],
    "isActive": true,
    "consecutiveFailures": 0
  }
}

{
  "error": "Connection timed out"
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

Resume Twitter webhook deliveries & retry events

curl --request POST \
  --url https://xquik.com/api/v1/webhooks/{id}/resume \
  --header 'x-api-key: <api-key>'

const options = {method: 'POST', headers: {'x-api-key': '<api-key>'}};

fetch('https://xquik.com/api/v1/webhooks/{id}/resume', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/webhooks/{id}/resume"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "success": true,
  "statusCode": 123,
  "webhook": {
    "id": "<string>",
    "url": "<string>",
    "eventTypes": [
      "<string>"
    ],
    "isActive": true,
    "consecutiveFailures": 123,
    "deliveryStatus": "<string>",
    "failureHardCap": 123,
    "createdAt": "<string>"
  },
  "error": "<string>"
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Resume Twitter webhook deliveries & retry events

Path parameters

Headers

What happens

Response

200 OK

400 Test failed

400 Invalid request

401 Unauthenticated

404 Not found

429 Rate limited

Recovery handoff

Needs attention

Signed test required

Failure counter

No secret rotation

Delivery log

Event replay

​Path parameters

​Headers

​What happens

​Response

​200 OK

​400 Test failed

​400 Invalid request

​401 Unauthenticated

​404 Not found

​429 Rate limited

​Recovery handoff

Needs attention

Signed test required

Failure counter

No secret rotation

Delivery log

Event replay

Path parameters

Headers

What happens

Response

200 OK

400 Test failed

400 Invalid request

401 Unauthenticated

404 Not found

429 Rate limited

Recovery handoff