Required Permissions: The user must be an admin or have workspace-manage-config:write permissions.
Path parameters
webhookIdstringRequiredThe id of the webhook.
Request
This endpoint expects an object.
namestringRequired
The name of this webhook event.
uristringRequired
The URI to call.
eventsstringRequired
The event(s) that trigger the web hook.
A comma-separated list of events that trigger the webhook.
The allowed events depend on the webhook type.
For type 'custom': retrieve the list of allowed events from '/webhooks/eventTypes'
For type 'slack': retrieve the list of allowed events from '/webhooks/eventTypes/slack'
isActivebooleanRequired
Whether the web hook is currently active.
authenticationTypestringRequired
The authentication type to use when calling the URI.
Can be 'none', 'header'.
languagestringOptional
The language of the web hook message that will be sent to the receiver.
Not required for custom web hooks.
authenticationstringOptional
The authentication value to use when calling the URI.
Should be 'key=value'.
In case of header authentication, this should be 'headername=headervalue'.
Only required when the AuthenticationType is anything other than 'none'.
Response
This endpoint returns an object
namestring
The name of this webhook event.
uristring
The URI to call.
eventsstring
The event(s) that trigger the web hook.
A comma-separated list of events that trigger the webhook.
The allowed events depend on the webhook type.
For type 'custom': retrieve the list of allowed events from '/webhooks/eventTypes'
For type 'slack': retrieve the list of allowed events from '/webhooks/eventTypes/slack'
isActiveboolean
Whether the web hook is currently active.
authenticationTypestring
The authentication type to use when calling the URI.
Can be 'none', 'header'.
languagestringOptional
The language of the web hook message that will be sent to the receiver.
Not required for custom web hooks.
authenticationstringOptional
The authentication value to use when calling the URI.
Should be 'key=value'.
In case of header authentication, this should be 'headername=headervalue'.
Only required when the AuthenticationType is anything other than 'none'.
idstringOptional
The id of the webhook config.
receiverTypestringOptional
The type of the web hook.
Can be 'custom', 'slack'.
lastFailureReasonstringOptional
The most recent failure reason.
createdOndatetimeOptional
The date this webhook config was created.
createdBystringOptional
The id of the user who created this webhook config.
updatedOndatetimeOptional
The date this webhook config was last modified.
updatedBystringOptional
The id of the user who last modified this webhook config.