Skip to content

Updates a webhook

PATCH
/webhook/{name}

Partially updates an existing webhook by name. Only fields included in the request body are modified; omitted fields (including the top-level url and any nested per-event URLs) keep their stored value. Passing null for a per-event URL clears it; the parent group is dropped when it has no per-event URLs left. Returns 400 when the path name fails the slug pattern, the body fails validation, or any URL uses a non-https scheme, fails to resolve, or resolves to a private/loopback address. Returns 404 when the organization has no source configured or no webhook with that name exists. The signing secret is preserved and is not returned in the response. Only owner and admin roles can update a webhook.

name
required
string
/^[a-z0-9-]{1,64}$/
object
url
string format: uri
transaction
object
created
Any of:
string format: uri
nullable
updated
Any of:
string format: uri
nullable
completed
Any of:
string format: uri
nullable
card
object
updated
Any of:
string format: uri
nullable
user
object
updated
Any of:
string format: uri
nullable

Webhook updated

object
url
required
string format: uri
transaction
object
created
string format: uri
updated
string format: uri
completed
string format: uri
card
object
updated
string format: uri
user
object
updated
string format: uri
name
required
string
/^[a-z0-9-]{1,64}$/

Invalid webhook name, body, or URL

object
code
required
string
Example
invalid name
message
Array<string>

Unauthorized

object
code
required
Allowed values: unauthorized
Example
unauthorized

User doesn’t belong to the organization

Any of:
object
code
required
Allowed values: no organization
Example
no organization

Webhook not found

object
code
required
Allowed values: not found
Example
not found