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 '{
    webhook_id: .id,
    url,
    event_types: .eventTypes,
    is_active: .isActive,
    test_endpoint: ("/api/v1/webhooks/" + .id + "/test"),
    deliveries_endpoint: ("/api/v1/webhooks/" + .id + "/deliveries")
  }'
These snippets shape a reconfiguration row. Store the current webhook configuration with its test and delivery-log endpoints instead of printing the full update response.

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

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 Webhook
Last modified on May 23, 2026