Slack

Slack is a team communication tool, that brings together all of your team communications in one place, instantly searchable and available wherever you go.

This connector is available in the following products and regions:

Service	Class	Regions
Copilot Studio	Standard	All Power Automate regions except the following: - China Cloud operated by 21Vianet
Logic Apps	Standard	All Logic Apps regions except the following: - Azure China regions - US Department of Defense (DoD)
Power Apps	Standard	All Power Apps regions except the following: - China Cloud operated by 21Vianet
Power Automate	Standard	All Power Automate regions except the following: - China Cloud operated by 21Vianet

Contact
Name	Microsoft
URL	https://support.microsoft.com/contactus

Connector Metadata
Publisher	Microsoft
Website	https://slack.com/
Privacy policy	https://slack.com/privacy-policy
Categories	Collaboration;Communication

Known Issues and Limitations

As per the Slack API documentation, some Slack API methods that the connector uses will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. So please use latest versions of below actions.

Actions:
Create a group is deprecated, please use latest version of Create a channel to create private channels.
The maximum number of characters in a message is limited to 4000. For more details, please refer to Slack's official documentation.

Connector in-depth

For more information about the connector, see the in-depth section.

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds
Frequency of trigger polls	1	120 seconds

Actions

Create a channel	Create a channel in slack.
Create a channel [DEPRECATED]	This action has been deprecated. Please use Create a channel instead. ~~Create a channel in slack.~~
Create a group [DEPRECATED]	Creates a group in slack.
Get user profile (Preview)	Get profile information for a Slack user. Useful for resolving the author of a message returned by List conversation messages or List message replies.
Join a channel [DEPRECATED]	This action has been deprecated. Please use Join a public channel instead. ~~Join a channel in slack.~~
Join a public channel	Join a public channel in slack.
List channels [DEPRECATED]	This action has been deprecated. Please use List public channels (Pagination support) instead. ~~List the channels in slack.~~
List conversation messages (Preview)	List the messages posted in a conversation (public channel, private channel, direct message, or group direct message).
List message replies (Preview)	List the replies in a message thread, including the parent message.
List public channels	List the public channels in slack.
List public channels (Pagination support) (Preview)	List the public channels in slack.
Post message (V2)	This operation is used to post a message to the specified channel.
Post message [DEPRECATED]	This action has been deprecated. Please use Post message (V2) instead. ~~This operation is used to post a message to the specified channel.~~
Set do not disturb	Set the do not disturb status for the user.

Create a channel

Operation ID:: CreateChannel_V2

Create a channel in slack.

Parameters

Name	Key	Required	Type	Description
Name	name		string	The name of the new channel.
Is Private channel?	is_private		boolean	Channel is private or not

Returns

Body: CreateChannel_Response

Create a channel [DEPRECATED]

Operation ID:: CreateChannel

This action has been deprecated. Please use Create a channel instead.

~~Create a channel in slack.~~

Parameters

Name	Key	Required	Type	Description
Name	name		string	The name of the new channel.

Returns

Body: CreateChannel_Response

Create a group [DEPRECATED]

Operation ID:: CreateGroup

Creates a group in slack.

Parameters

Name	Key	Required	Type	Description
Name	name		string	The name of the group.

Returns

Name	Path	Type	Description
Id	group.id	string	The id of the group.
Name	group.name	string	The name of the group.

Get user profile (Preview)

Operation ID:: GetUserProfile

Get profile information for a Slack user. Useful for resolving the author of a message returned by List conversation messages or List message replies.

Parameters

Name	Key	Required	Type	Description
User Id	user	True	string	The id of the user to get profile information for.

Returns

Body: GetUserProfile_Response

Join a channel [DEPRECATED]

Operation ID:: JoinChannel

This action has been deprecated. Please use Join a public channel instead.

~~Join a channel in slack.~~

Parameters

Name	Key	Required	Type	Description
Name	name		string	The name of the channel.

Returns

Body: JoinChannel_Response

Join a public channel

Operation ID:: JoinChannel_V2

Join a public channel in slack.

Parameters

Name	Key	Required	Type	Description
Channel Name	channel		string	The name of the channel.

Returns

Body: JoinChannel_ResponseV2

List channels [DEPRECATED]

Operation ID:: ListChannels

This action has been deprecated. Please use List public channels (Pagination support) instead.

~~List the channels in slack.~~

Returns

Body: ListChannels_Response

List conversation messages (Preview)

Operation ID:: ListConversationMessages

List the messages posted in a conversation (public channel, private channel, direct message, or group direct message).

Parameters

Name	Key	Required	Type	Description
Conversation Id	channel	True	string	The conversation to fetch messages from.
Maximum Results	limit		integer	The maximum number of messages to return per page.
Oldest Timestamp	oldest		string	Only messages after this Unix timestamp will be included in the results.
Latest Timestamp	latest		string	Only messages before this Unix timestamp will be included in the results.
Inclusive	inclusive		boolean	Include messages with the oldest or latest timestamps in the results.
Include All Metadata	include_all_metadata		boolean	Return all metadata associated with each message.

Returns

Body: ListMessages_Response

List message replies (Preview)

Operation ID:: ListMessageReplies

List the replies in a message thread, including the parent message.

Parameters

Name	Key	Required	Type	Description
Conversation Id	channel	True	string	The conversation containing the thread.
Parent Message Timestamp	ts	True	string	Timestamp of the parent message that starts the thread. Available as the `ts` field on a message returned by List conversation messages.
Maximum Results	limit		integer	The maximum number of messages to return per page.
Oldest Timestamp	oldest		string	Only messages after this Unix timestamp will be included in the results.
Latest Timestamp	latest		string	Only messages before this Unix timestamp will be included in the results.
Inclusive	inclusive		boolean	Include messages with the oldest or latest timestamps in the results.

Returns

Body: ListMessages_Response

List public channels

Operation ID:: ListChannels_V2

List the public channels in slack.

Parameters

Name	Key	Type	Description
Conversation Types	types	string	Comma-separated conversation types to include. Defaults to public_channel. Explicitly include private_channel, im, or mpim to list other conversation types.
Exclude Archived	exclude_archived	boolean	Set to true to exclude archived conversations.
Maximum Results	limit	integer	The maximum number of conversations to return.
Team Id	team_id	string	Encoded team id. Required only for an org-wide token.
Cursor	cursor	string	Pagination cursor returned by the previous request.

Returns

Body: ListChannels_Response

List public channels (Pagination support) (Preview)

Operation ID:: ListChannels_V3

List the public channels in slack.

Returns

Body: ListChannels_ResponseV3

Post message (V2)

Operation ID:: PostMessage_V2

This operation is used to post a message to the specified channel.

Parameters

Name	Key	Required	Type	Description
Channel Name	channel	True	string	Channel, private group, or IM channel to send message to. Can be a name(ex: #general) or an encoded ID.
Message Text	text	True	string	Body of the message to send. Slack API will truncate messages containing more than 40,000 characters. For formatting options, see https://api.slack.com/docs/formatting
Parent Message Timestamp	thread_ts		string	Timestamp of the parent message when posting a reply in a thread.
Broadcast To Channel	reply_broadcast		boolean	Pass true to also send a threaded reply to the channel.
Bot Name	username		string	Name of the bot.
Post As User	as_user		boolean	Pass true to post the message as the authenticated user, instead of as a bot.
Parse Mode	parse		string	Change how messages are treated. For details, see https://api.slack.com/docs/formatting
Slack markup parsing	mrkdwn		boolean	Slack markup parsing setting. Enabled by default.
Link Names	link_names		integer	Find and link channel names and usernames.
Unfurl Links	unfurl_links		boolean	Pass true to enable unfurling of primarily text-based content.
Unfurl Media	unfurl_media		boolean	Pass false to disable unfurling of media content.
Icon Url	icon_url		uri	URL to an image to use as an icon for this message.
Icon Emoji	icon_emoji		string	Emoji to use as an icon for this message.

Returns

Details of the message posted to a Slack channel.

Body: PostMessageResponse

Post message [DEPRECATED]

Operation ID:: PostMessage

This action has been deprecated. Please use Post message (V2) instead.

~~This operation is used to post a message to the specified channel.~~

Parameters

Name	Key	Required	Type	Description
Channel Name	channel	True	string	Channel, private group, or IM channel to send message to. Can be a name(ex: #general) or an encoded ID.
Message Text	text	True	string	Body of the message to send (less than 4000 characters). For formatting options, see https://api.slack.com/docs/formatting.
Bot Name	username		string	Name of the bot.
Post As User	as_user		boolean	Pass true to post the message as the authenticated user, instead of as a bot.
Parse Mode	parse		string	Change how messages are treated. For details, see https://api.slack.com/docs/formatting.
Link Names	link_names		integer	Find and link channel names and usernames.
Unfurl Links	unfurl_links		boolean	Pass true to enable unfurling of primarily text-based content.
Unfurl Media	unfurl_media		boolean	Pass false to disable unfurling of media content.
Icon Url	icon_url		uri	URL to an image to use as an icon for this message.
Icon Emoji	icon_emoji		string	Emoji to use as an icon for this message.

Returns

Name	Path	Type	Description
Success Result	ok	boolean	Indicates if the operation was successful.
Channel	channel	string	The channel which the message was posted to.
Created Date-Time	ts	string	yyyy-MM-ddTHH:mm:ss.fffZ
Message Text	message.text	string	Body of the message.
Message Id	message.id	string	Unique identifier of the message.
Creator Id	message.user	string	Unique identifier of the user who posted the message.
Created Time	message.created	integer	Unix timestamp for when the message is created.
Is Deleted	message.is_user-deleted	boolean	Whether or not the message has been deleted.
Error Messages	error	string	Details of the error messages, if any.

Set do not disturb

Operation ID:: SetDND

Set the do not disturb status for the user.

Parameters

Name	Key	Required	Type	Description
Number of minutes	num_minutes		string	The number of minutes to set do not disturb.

Returns

Name	Path	Type	Description
Snooze Enabled	snooze_enabled	boolean	Whether snooze is enabled.

Triggers

When a file is created

Operation ID:: OnNewFile

When a file is created

Parameters

Name	Key	Required	Type	Description
Channel	channel	True	string	The name of the channel.

Returns

Name	Path	Type	Description
Id	id	string	Id of the file
Created	created	integer	When the file was created.
Name	name	string	The name of the file.
Title	title	string	The title of the file.

Definitions

Channel

The Channel

Name	Path	Type	Description
Id	id	string	The id of the channel.
Name	name	string	The name of channel.
Is Public Channel	is_channel	boolean	Whether this conversation is a public channel.
Is Private Channel	is_group	boolean	Whether this conversation is a private channel.
Is Direct Message	is_im	boolean	Whether this conversation is a direct message between two users.
Is Group Direct Message	is_mpim	boolean	Whether this conversation is a group direct message.
Is Private	is_private	boolean	Whether this conversation is private.
Is Archived	is_archived	boolean	Whether this conversation has been archived.
Is Member	is_member	boolean	Whether the authenticated user is a member of this conversation.
User Id	user	string	For direct messages, the id of the other user in the conversation.
Member Count	num_members	integer	The number of members in this conversation.

ListChannels_Response

Name	Path	Type	Description
channels	channels	array of Channel
Next Cursor	response_metadata.next_cursor	string	Cursor to pass to the next request. Empty when there are no more results.

ListChannels_ResponseV3

Name	Path	Type	Description
value	value	array of Channel

SlackMessage

A message posted in a Slack conversation.

Name	Path	Type	Description
Message Id	ts	string	Unique timestamp identifier of the message.
Author Id	user	string	The id of the user who posted the message. Use Get user profile to resolve this to a user.
Message Text	text	string	Body of the message.
Message Type	type	string	Type of the message.
Thread Id	thread_ts	string	The timestamp of the parent message, if this message is part of a thread.
Reply Count	reply_count	integer	The number of replies to this message, if it starts a thread.

ListMessages_Response

Name	Path	Type	Description
value	value	array of SlackMessage

SlackUserProfile

Additional profile details for a Slack user.

Name	Path	Type	Description
Display Name	display_name	string	The display name the user has chosen for their profile.
Real Name	real_name	string	The user's first and last name.
Email	email	string	The user's email address.
Avatar Url	image_72	string	URL of a 72x72 pixel version of the user's avatar.

SlackUser

A Slack user.

Name	Path	Type	Description
Id	id	string	The id of the user.
Username	name	string	The user's Slack username.
Real Name	real_name	string	The user's first and last name.
Is Bot	is_bot	boolean	Whether the user is a bot.
Is Deactivated	deleted	boolean	Whether the user's account has been deactivated.
Time Zone	tz	string	The human readable time zone of the user.
Profile	profile	SlackUserProfile	Additional profile details for a Slack user.

GetUserProfile_Response

Name	Path	Type	Description
Success Result	ok	boolean	Indicates if the operation was successful.
User	user	SlackUser	A Slack user.
Error Messages	error	string	Details of the error messages, if any.

CreateChannel_Response

Name	Path	Type	Description
Channel	channel	Channel	The Channel

JoinChannel_Response

Name	Path	Type	Description
Already in channel	already_in_channel	boolean	Whether the user is already in the channel or not.
Channel	channel	Channel	The Channel

JoinChannel_ResponseV2

Name	Path	Type	Description
Channel	channel	Channel	The Channel
Warning	warning	string	Whether the user is already in the channel or not.

PostMessageResponse

Details of the message posted to a Slack channel.

Name	Path	Type	Description
Success Result	ok	boolean	Indicates if the operation was successful.
Channel	channel	string	The channel which the message was posted to.
Created Time	ts	string	Unix timestamp for when the message was created.
Message Type	message.type	string	Type of the message.
Message Text	message.text	string	Body of the message.
Created Time	message.ts	string	Unix timestamp for when the message was created.
Error Messages	error	string	Details of the error messages, if any.