Sign in
webhooks

Create an incoming webhook

Create an incoming webhook for a channel.

Permissions

manage_webhooks for the team the webhook is in.

manage_others_incoming_webhooks for the team the webhook is in if the user is different than the requester.

post/api/v4/hooks/incoming

Request body

channel_idstring required

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

user_idstring

The ID of the owner of the webhook if different than the requester.

display_namestring

The display name for this incoming webhook

descriptionstring

The description for this incoming webhook

usernamestring

The username this incoming webhook will post as.

icon_urlstring

The profile picture this incoming webhook will use when posting.

Response

Incoming webhook creation successful

idstring

The unique identifier for this incoming webhook

create_atinteger

The time in milliseconds a incoming webhook was created

update_atinteger

The time in milliseconds a incoming webhook was last updated

delete_atinteger

The time in milliseconds a incoming webhook was deleted

channel_idstring

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

descriptionstring

The description for this incoming webhook

display_namestring

The display name for this incoming webhook

Changes