Skip to main content
PATCH
/
webhooks
/
{id}
Update webhook
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
}
'

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

Path parameters

id
string
required
The webhook ID to update.

Headers

x-api-key
string
required
Your API key. This endpoint also accepts session cookie authentication.
Content-Type
string
required
Must be application/json.

Body

At least 1 field is required.
url
string
New HTTPS endpoint URL. HTTP URLs are rejected.
eventTypes
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.

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.
isActive
boolean
Set to false to pause deliveries or true to resume.

Response

id
string
Unique webhook identifier.
url
string
The current delivery endpoint URL.
eventTypes
string[]
Event types this webhook is subscribed to.
isActive
boolean
Whether the webhook is currently active.
createdAt
string
ISO 8601 creation timestamp.
{
  "id": "15",
  "url": "https://new-server.com/webhook",
  "eventTypes": ["tweet.new"],
  "isActive": false,
  "createdAt": "2026-02-24T10:30:00.000Z"
}

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.
This endpoint supports dual authentication: API key (x-api-key header) or session cookie from the dashboard.Related: List Webhooks · Delete Webhook
Last modified on May 20, 2026