Sign in
webhooks

Update an outgoing webhook

Update an outgoing webhook given the hook id.

Permissions

manage_webhooks for system or manage_webhooks for the specific team or manage_webhooks for the channel.

put/api/v4/hooks/outgoing/{hook_id}

Path parameters

hook_idstring required

outgoing Webhook GUID

Request body

idstring required

Outgoing webhook GUID

channel_idstring required

The ID of a public channel or private group that receives the webhook payloads.

display_namestring required

The display name for this incoming webhook

descriptionstring required

The description for this incoming webhook

Response

Webhook update successful

idstring

The unique identifier for this outgoing webhook

create_atinteger

The time in milliseconds a outgoing webhook was created

update_atinteger

The time in milliseconds a outgoing webhook was last updated

delete_atinteger

The time in milliseconds a outgoing webhook was deleted

creator_idstring

The Id of the user who created the webhook

team_idstring

The ID of the team that the webhook watchs

channel_idstring

The ID of a public channel that the webhook watchs

descriptionstring

The description for this outgoing webhook

display_namestring

The display name for this outgoing webhook

trigger_wordsstring[]

List of words for the webhook to trigger on

trigger_wheninteger

When to trigger the webhook, 0 when a trigger word is present at all and 1 if the message starts with a trigger word

callback_urlsstring[]

The URLs to POST the payloads to when the webhook is triggered

content_typestring

The format to POST the data in, either application/json or application/x-www-form-urlencoded

Changes