Webhooks

Update a webhook

Change the URL, the headers, the event types, or several at once, or turn on a webhook that was turned off after 3 days without a 2xx (enabled: true). Only the member who created the webhook can change it. Pending deliveries of event types no longer picked are dropped. Only the headers named change: a value sets or replaces one, null removes it. A new URL removes all saved headers first. The secret stays the same, and pending deliveries go out with the new URL and headers. Header values you send pass through your AI app.

TOOLneedleUpdateWebhook

Input

webhookIdrequired

string · uuid

Webhook id

urloptional

string · uri

The new URL. A different URL removes all saved headers first.

headersoptional

object

Changes only the headers named here: a value sets or replaces that header, null removes it. Headers not named stay, except when url changes: then only the headers sent here are kept.

eventTypesoptional

string | string[]

The new event types: "all" or a list. Pending deliveries of types no longer in the list are dropped; added types only get events from now on.

enabledoptional

boolean

Turns on a webhook that was turned off. Events from while it was off are not sent. Any other change turns it on too.

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy