Skip to main content
PUT
Update webhook
Applies a partial update. Send only the fields you want to change: anything you leave out keeps its stored value.

Authentication

Send your API key as a bearer token.
Updating a webhook requires the workspace admin role. tech and readonly keys get 403.

Request

string
required
The webhook ID to update. This is the only required field.
string
A new HTTPS URL. Must resolve to a public address. Ignored for telegram webhooks, whose target comes from the bot token.
string[]
Replaces the subscribed events. Must be non-empty, known, and free of duplicates. See supported events.
string
A new label. Trimmed, and limited to 255 characters. Send "" to clear it.
boolean
Set to false to pause deliveries without deleting the webhook. Set to true to resume.
string
Re-points a telegram webhook at a different chat. Ignored for other kinds.
The destination kind is immutable. To move from a generic endpoint to Slack, delete the webhook and create a new one.

Examples

Response

Returns 200 OK. The updated webhook is not echoed back. Call list webhooks or get webhook to read the new state.
boolean
true when the update was applied.
object
string
A human-readable summary.
Example response

Errors

A missing id returns 422, not 400: the body parsed correctly, but a required value was absent.
Example error

Next steps

Send a test event

Confirm the new URL is reachable.

Inspect deliveries

See whether deliveries resumed.

Delete a webhook

Remove an endpoint for good.

Supported events

Every event you can subscribe to.