Webhooks
Update webhook
Update the URL, event types, or active state of an existing webhook
PATCH
Update webhook
Documentation Index
Fetch the complete documentation index at: https://docs.xquik.com/llms.txt
Use this file to discover all available pages before exploring further.
Free - does not consume credits
Path parameters
The webhook ID to update.
Headers
Your API key. This endpoint also accepts session cookie authentication.
Must be
application/json.Body
At least 1 field is required.New HTTPS endpoint URL. HTTP URLs are rejected.
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 downstream 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.
webhook.test is generated only by the Test Webhook endpoint. It cannot be added to a webhook subscription.Set to
false to pause deliveries or true to resume.Response
- 200 OK
- 401 Unauthenticated
- 400 Invalid Input
- 404 Not Found
- 429 Rate Limited
Reconfiguration handoff
Use this endpoint when a receiver URL changes, an event filter changes, or an operator needs to pause or resume webhook delivery without creating a new endpoint.Updated Inventory
Store returned
id, url, eventTypes, isActive, 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.Resume Delivery
isActive: true resumes delivery for matching future monitor events. Test
the receiver after resuming.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 supports dual authentication: API key (
x-api-key header) or session cookie from the dashboard.Related: List Webhooks · Test Webhook · List Deliveries · Get Event · Delete WebhookLast modified on May 23, 2026
Update webhook