Create Incoming Webhook

Create an incoming webhook for a channel.

Required Permissions: manage_webhooks for the team or manage_others_incoming_webhooks for system-wide management.

External Documentation

To learn more, visit the Mattermost documentation.

​

Parameters

Parameter	Description
Channel ID	The ID of the channel. Can be obtained from the List All Channels action.
Channel Locked	Select to lock the webhook to the configured channel.
Description	A description of the incoming webhook.
Display Name	The display name of the incoming webhook.
Icon URL	The URL of the icon image to use for posts from this webhook.
User ID	The ID of the user. Can be obtained from the List Users action.
Username	The username to use for posts from this webhook.

​

Example Output

{
	"id": "string",
	"create_at": -9007199254740991,
	"update_at": -9007199254740991,
	"delete_at": -9007199254740991,
	"user_id": "string",
	"channel_id": "string",
	"team_id": "string",
	"display_name": "string",
	"description": "string",
	"username": "string",
	"icon_url": "string",
	"channel_locked": true
}