Update Twitter webhook endpoint & event filters

{
  "id": "42",
  "url": "https://example.com/webhook",
  "eventTypes": [
    "tweet.new"
  ],
  "isActive": true,
  "consecutiveFailures": 0,
  "deliveryStatus": "active",
  "failureHardCap": 200,
  "createdAt": "2025-01-15T12:00:00Z"
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

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

PATCH

webhooks

{id}

Update Twitter webhook endpoint & event filters

curl --request PATCH \
  --url https://xquik.com/api/v1/webhooks/{id} \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "url": "<string>",
  "eventTypes": [
    "<string>"
  ],
  "isActive": true
}
'

import requests

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

payload = {
    "url": "<string>",
    "eventTypes": ["<string>"],
    "isActive": True
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "<content-type>"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'x-api-key': '<api-key>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({url: '<string>', eventTypes: ['<string>'], isActive: true})
};

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"url\": \"<string>\",\n  \"eventTypes\": [\n    \"<string>\"\n  ],\n  \"isActive\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "<content-type>")

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

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

	fmt.Println(string(body))

}

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

Free. This endpoint does not consume credits.

curl -X PATCH https://xquik.com/api/v1/webhooks/15 \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://new-server.com/webhook",
    "eventTypes": ["tweet.new"],
    "isActive": false
  }' | jq '{
    webhook_id: .id,
    url,
    event_types: .eventTypes,
    is_active: .isActive,
    delivery_status: .deliveryStatus,
    consecutive_failures: .consecutiveFailures,
    failure_hard_cap: .failureHardCap,
    test_endpoint: ("/api/v1/webhooks/" + .id + "/test"),
    resume_endpoint: ("/api/v1/webhooks/" + .id + "/resume"),
    deliveries_endpoint: ("/api/v1/webhooks/" + .id + "/deliveries")
  }'

const response = await fetch("https://xquik.com/api/v1/webhooks/15", {
  method: "PATCH",
  headers: {
    "x-api-key": "xq_YOUR_KEY_HERE",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://new-server.com/webhook",
    eventTypes: ["tweet.new"],
    isActive: false,
  }),
});
const webhook = await response.json();
const updateHandoff = {
  webhook_id: webhook.id,
  url: webhook.url,
  event_types: webhook.eventTypes,
  is_active: webhook.isActive,
  delivery_status: webhook.deliveryStatus,
  consecutive_failures: webhook.consecutiveFailures,
  failure_hard_cap: webhook.failureHardCap,
  test_endpoint: `/api/v1/webhooks/${webhook.id}/test`,
  resume_endpoint: `/api/v1/webhooks/${webhook.id}/resume`,
  deliveries_endpoint: `/api/v1/webhooks/${webhook.id}/deliveries`,
};

import requests

response = requests.patch(
    "https://xquik.com/api/v1/webhooks/15",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
    json={
        "url": "https://new-server.com/webhook",
        "eventTypes": ["tweet.new"],
        "isActive": False,
    },
)
webhook = response.json()
update_handoff = {
    "webhook_id": webhook["id"],
    "url": webhook["url"],
    "event_types": webhook["eventTypes"],
    "is_active": webhook["isActive"],
    "delivery_status": webhook["deliveryStatus"],
    "consecutive_failures": webhook["consecutiveFailures"],
    "failure_hard_cap": webhook["failureHardCap"],
    "test_endpoint": f"/api/v1/webhooks/{webhook['id']}/test",
    "resume_endpoint": f"/api/v1/webhooks/{webhook['id']}/resume",
    "deliveries_endpoint": f"/api/v1/webhooks/{webhook['id']}/deliveries",
}

package main

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

type Webhook struct {
  ConsecutiveFailures int      `json:"consecutiveFailures"`
  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 UpdateHandoff struct {
  ConsecutiveFailures int      `json:"consecutive_failures"`
  DeliveriesEndpoint string   `json:"deliveries_endpoint"`
  DeliveryStatus     string   `json:"delivery_status"`
  EventTypes         []string `json:"event_types"`
  FailureHardCap     int      `json:"failure_hard_cap"`
  IsActive           bool     `json:"is_active"`
  ResumeEndpoint     string   `json:"resume_endpoint"`
  TestEndpoint       string   `json:"test_endpoint"`
  URL                string   `json:"url"`
  WebhookID          string   `json:"webhook_id"`
}

func main() {
  payload := map[string]interface{}{
    "url":        "https://new-server.com/webhook",
    "eventTypes": []string{"tweet.new"},
    "isActive":   false,
  }
  body, err := json.Marshal(payload)
  if err != nil {
    log.Fatal(err)
  }

  req, err := http.NewRequest("PATCH", "https://xquik.com/api/v1/webhooks/15", bytes.NewReader(body))
  if err != nil {
    log.Fatal(err)
  }
  req.Header.Set("x-api-key", "xq_YOUR_KEY_HERE")
  req.Header.Set("Content-Type", "application/json")

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

  var webhook Webhook
  if err := json.NewDecoder(resp.Body).Decode(&webhook); err != nil {
    log.Fatal(err)
  }
  handoff := UpdateHandoff{
    ConsecutiveFailures: webhook.ConsecutiveFailures,
    DeliveriesEndpoint: "/api/v1/webhooks/" + webhook.ID + "/deliveries",
    DeliveryStatus:     webhook.DeliveryStatus,
    EventTypes:         webhook.EventTypes,
    FailureHardCap:     webhook.FailureHardCap,
    IsActive:           webhook.IsActive,
    ResumeEndpoint:     "/api/v1/webhooks/" + webhook.ID + "/resume",
    TestEndpoint:       "/api/v1/webhooks/" + webhook.ID + "/test",
    URL:                webhook.URL,
    WebhookID:          webhook.ID,
  }
  _ = handoff
}

These snippets build a reconfiguration row. Store the current webhook configuration with its test and delivery-log endpoints. Do not print the full update response.

Webhook update column	Request or response source	Verification rule
Webhook ID	Path `{id}` and response `id`	Require both IDs to match.
Receiver URL	Request and response `url`	Confirm the intended HTTPS endpoint.
Event filter	Request and response `eventTypes`	Confirm the complete replacement list.
Active state	Request and response `isActive`	Verify the intended pause or activation.
Failure count	Response `consecutiveFailures`	Confirm whether activation reset failures.
Delivery state	Response `deliveryStatus`	Handle active, paused, and needs-attention receivers separately.
Failure cap	Response `failureHardCap`	Record the failure cap.

Path parameters

string

required

The webhook ID to update.

Headers

string

required

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

string

required

Must be application/json.

Body

At least 1 field is required.

string

New HTTPS endpoint URL. Xquik rejects HTTP URLs.

string[]

Updated event types to subscribe to. Replaces the existing list. At least 1 required when provided. Use any valid account monitor event type listed below. Keyword monitor webhooks should stay on tweet.* event types. Account monitor webhooks can use both tweet.* and profile.* event types.

Valid event types

Valid types: tweet.new, tweet.quote, tweet.reply, tweet.retweet, tweet.media, tweet.link, tweet.poll, tweet.mention, tweet.hashtag, tweet.longform, profile.avatar.changed, profile.banner.changed, profile.name.changed, profile.username.changed, profile.bio.changed, profile.location.changed, profile.url.changed, profile.verified.changed, profile.protected.changed, profile.pinned_tweet.changed, profile.unavailable.changed.

tweet.new

Original tweet from an account monitor or matching keyword monitor. Use for new posts that are not replies, quotes, or retweets.

tweet.quote

Quote tweet from an account monitor or matching keyword monitor. Keep this only when your systems handle quote payloads.

tweet.reply

Reply from an account monitor or matching keyword monitor. Keep this when reply alerts or support routing should continue.

tweet.retweet

Retweet from an account monitor or matching keyword monitor. Keep this when repost activity should keep triggering deliveries.

Only the Test Webhook endpoint generates webhook.test. You cannot add it to a webhook subscription.

boolean

Set to false to pause deliveries. Set to true to turn it on and start sending waiting deliveries at once. Either value resets consecutiveFailures to 0. To require a signed test first, use Resume Webhook.

Response

200 OK

string

Unique webhook identifier.

string

The current delivery endpoint URL.

string[]

Event types this webhook subscribes to.

boolean

Whether the webhook is active.

number

Consecutive delivery failures recorded for this webhook.

string

active, paused, or needs_attention.

number

Failure count that sets needs_attention. Delivery continues past it.

string

ISO 8601 creation timestamp.

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

401 Unauthenticated

{ "error": "unauthenticated" }

Missing or invalid API key or session cookie.

400 Invalid input

{ "error": "invalid_input" }

Invalid URL (must be HTTPS), empty eventTypes, or no fields provided.

{ "error": "invalid_id" }

The provided webhook ID is not a valid format.

404 Not found

{ "error": "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.

Reconfiguration handoff

Use this endpoint when a receiver URL or event filter changes. It also pauses or resumes webhook delivery without creating a new endpoint.

Updated inventory

Store returned id, url, eventTypes, isActive, deliveryStatus, consecutiveFailures, failureHardCap, and createdAt as the current webhook configuration.

URL change

After changing url, run Test Webhook before expecting production monitor events at the new receiver.

Event filter

eventTypes replaces the previous list. Keep it aligned with account or keyword monitor event types.

Pause delivery

isActive: false stops future deliveries. Existing stored events and delivery records remain available. Xquik keeps queued events until all deliveries finish. Events expire 30 days after Xquik creates them.

Resume delivery

isActive: true resumes delivery for matching future monitor events. It also starts sending waiting deliveries at once. Events that happen during a pause may never arrive. To catch up, page through List Events. Use Resume Webhook when the receiver must pass a signed test first.

Signing secret

This endpoint does not rotate or return secret. Keep using the secret from Create Webhook for signature verification.

Delivery check

After the signed test passes, use List Deliveries if production monitor events still miss the receiver. Check status, attempts, lastStatusCode, lastError, createdAt, and deliveredAt.

Event join

Use delivery streamEventId as the {id} for Get Event. Store monitorId, monitorType, type, occurredAt, and data with the reconfiguration incident.

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 · Test Webhook · Resume Webhook · List Deliveries · Get Event · Delete Webhook

{
  "id": "42",
  "url": "https://example.com/webhook",
  "eventTypes": [
    "tweet.new"
  ],
  "isActive": true,
  "consecutiveFailures": 0,
  "deliveryStatus": "active",
  "failureHardCap": 200,
  "createdAt": "2025-01-15T12:00:00Z"
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

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

Update Twitter webhook endpoint & event filters

curl --request PATCH \
  --url https://xquik.com/api/v1/webhooks/{id} \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "url": "<string>",
  "eventTypes": [
    "<string>"
  ],
  "isActive": true
}
'

import requests

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

payload = {
    "url": "<string>",
    "eventTypes": ["<string>"],
    "isActive": True
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "<content-type>"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'x-api-key': '<api-key>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({url: '<string>', eventTypes: ['<string>'], isActive: true})
};

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"url\": \"<string>\",\n  \"eventTypes\": [\n    \"<string>\"\n  ],\n  \"isActive\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "<content-type>")

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

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

	fmt.Println(string(body))

}

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

​Path parameters

​Headers

​Body

​Valid event types

tweet.new

tweet.quote

tweet.reply

tweet.retweet

​Response

​200 OK

​401 Unauthenticated

​400 Invalid input

​404 Not found

​429 Rate limited

​Reconfiguration handoff

Updated inventory

URL change

Event filter

Pause delivery

Resume delivery

Signing secret

Delivery check

Event join

Path parameters

Headers

Body

Valid event types

Response

200 OK

401 Unauthenticated

400 Invalid input

404 Not found

429 Rate limited

Reconfiguration handoff