Skip to main content

Slack

Type ID: slack  ·  Kind: Action  ·  Ports: 1 in, 1 out

Send messages to Slack channels, groups, and direct messages via the Slack Web API.

Credentials​

Connect a Slack Bot (slack_bot) or Slack User (slack_user) credential via the integration picker.

  • Slack Bot: Acts as the installed Slack app.
  • Slack User: Acts as the person who authorized the connection.

Note: The Search resource and User → Update Profile operation require a Slack User token.

Resources & operations​

  • Message (message)
    • Send (send) - Send a message to a channel, group, or user.
    • Send to Person by Email (sendByEmail) - Send a message to a user by their email address.
    • Send Visible to One Person (sendEphemeral) - Send an ephemeral message visible only to a specific user.
    • Schedule (schedule) - Schedule a message to be sent at a specific time.
    • List Scheduled (listScheduled) - List scheduled messages.
    • Cancel Scheduled (cancelScheduled) - Cancel a scheduled message.
    • Update (update) - Update an existing message.
    • Delete (delete) - Delete a message.
    • Get Thread Replies (getReplies) - Get replies to a message thread.
    • Get Message Link (getPermalink) - Get a permalink to a message.
  • Reaction (reaction)
    • Add (add) - Add a reaction to a message.
    • Remove (remove) - Remove a reaction from a message.
  • User (user)
    • Get by Email (getByEmail) - Get a user by their email address.
    • Get Many (getMany) - Get a list of users.
    • Get Profile (getProfile) - Get a user's profile.
    • Update Profile (updateProfile) - Update a user's profile.
  • Channel (channel)
    • Get Many (getMany) - Get a list of channels.
    • Create (create) - Create a new channel.
    • Archive (archive) - Archive a channel.
    • Set Topic (setTopic) - Set the topic of a channel.
    • Invite People (invite) - Invite users to a channel.
    • Remove Person (remove) - Remove a user from a channel.
  • File (file)
    • Upload (upload) - Upload a file.
    • Get Info (getInfo) - Get information about a file.
    • Download (download) - Download a file.
  • Search (search)
    • Messages (messages) - Search for messages.
    • Files (files) - Search for files.
  • Interaction (interaction)
    • Respond (respond) - Respond to an interaction.

For agent integrations (name: 'slack' in permissions.integrations), grant '*', a resource key, or an operation key — see Tools and Permissions:

Resource key (<resource>)Operation keys (<resource>.<operation>)
messagemessage.send, message.sendByEmail, message.update, message.delete, message.getReplies, message.getPermalink, message.schedule, message.listScheduled, message.cancelScheduled, message.sendEphemeral
reactionreaction.add, reaction.remove
useruser.getByEmail, user.getMany, user.getProfile, user.updateProfile
channelchannel.getMany, channel.create, channel.archive, channel.setTopic, channel.invite, channel.remove
filefile.upload, file.getInfo, file.download
searchsearch.messages, search.files
interactioninteraction.respond

Properties​

Common​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
ResourceresourceoptionsYesmessageMessage (message), Reaction (reaction), User (user), Channel (channel), File (file), Search (search), Interaction (interaction)-
OperationoperationoptionsYessendSend (send), Send to Person by Email (sendByEmail), Update (update), Delete (delete), Get Thread Replies (getReplies), Get Message Link (getPermalink), Schedule (schedule), List Scheduled (listScheduled), Cancel Scheduled (cancelScheduled), Send Visible to One Person (sendEphemeral)resource = message
OperationoperationoptionsYesaddAdd (add), Remove (remove)resource = reaction
OperationoperationoptionsYesgetByEmailGet by Email (getByEmail), Get Many (getMany), Get Profile (getProfile), Update Profile (updateProfile)resource = user
OperationoperationoptionsYesgetManyGet Many (getMany), Create (create), Archive (archive), Set Topic (setTopic), Invite People (invite), Remove Person (remove)resource = channel
OperationoperationoptionsYesuploadUpload (upload), Get Info (getInfo), Download (download)resource = file
OperationoperationoptionsYesmessagesMessages (messages), Files (files)resource = search
OperationoperationoptionsYesrespondRespond (respond)resource = interaction

Message → Send​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Channel/UserchannelstringYes''Channel name (e.g. #general), channel ID (e.g. C1234567890), or user ID (e.g. U1234567890)resource = message, operation = send
Message TexttextstringYes''Free text; supports markdown, @mentions, :emojis:, links (<url|text>)resource = message, operation = send
Advanced Message OptionsadditionalFieldsobjectNo{}Collection (see below)resource = message, operation = send

additionalFields collection options:

PropertyKeyTypeRequiredDefaultPossible values
Thread Timestampthread_tsstringNo''Parent message ts value to reply in-thread
Reply Broadcastreply_broadcastbooleanNofalsetrue / false
BlocksblocksjsonNo[]JSON array of Slack Block Kit blocks
Use MarkdownmrkdwnbooleanNotruetrue / false
Link Nameslink_namesbooleanNotruetrue / false
Unfurl Linksunfurl_linksbooleanNotruetrue / false
Unfurl Mediaunfurl_mediabooleanNotruetrue / false

Message → Send to Person by Email​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
EmailemailstringYes''Email address of the userresource = message, operation = sendByEmail
Message TexttextstringYes''Free textresource = message, operation = sendByEmail
Message OptionsmessageOptionsobjectNo{}Collection (Blocks, Use Markdown, Link Names, Unfurl Links, Unfurl Media)resource = message, operation = sendByEmail

Message → Send Visible to One Person​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
ChannelchannelstringYes''Channel IDresource = message, operation = sendEphemeral
User IDuserIdstringYes''User IDresource = message, operation = sendEphemeral
Message TexttextstringYes''Free textresource = message, operation = sendEphemeral
Ephemeral OptionsephemeralOptionsobjectNo{}Collection (Thread Timestamp, Blocks, Link Names)resource = message, operation = sendEphemeral

Message → Schedule​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
ChannelchannelstringYes''Channel IDresource = message, operation = schedule
Message TexttextstringYes''Free textresource = message, operation = schedule
Post AtpostAtdateTimeYes''Date and time to postresource = message, operation = schedule
Schedule OptionsscheduleOptionsobjectNo{}Collection (Thread Timestamp, Reply Broadcast, Blocks, Link Names, Unfurl Links, Unfurl Media)resource = message, operation = schedule

Message → List Scheduled​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Channel IDchannelIdstringNo''Channel IDresource = message, operation = listScheduled
OldestoldestdateTimeNo''Oldest timeresource = message, operation = listScheduled
LatestlatestdateTimeNo''Latest timeresource = message, operation = listScheduled
LimitlimitnumberNo100Number of itemsresource = message, operation = listScheduled
CursorcursorstringNo''Pagination cursorresource = message, operation = listScheduled

Message → Cancel Scheduled​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Channel IDchannelIdstringYes''Channel IDresource = message, operation = cancelScheduled
Scheduled Message IDscheduledMessageIdstringYes''Scheduled Message IDresource = message, operation = cancelScheduled

Message → Update​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Channel IDchannelIdstringYes''Channel IDresource = message, operation = update
Message TimestampmessageTsstringYes''Message Timestampresource = message, operation = update
Message TexttextstringYes''Free textresource = message, operation = update
BlocksblocksjsonNo[]JSON array of Slack Block Kit blocksresource = message, operation = update

Message → Delete​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Channel IDchannelIdstringYes''Channel IDresource = message, operation = delete
Message TimestampmessageTsstringYes''Message Timestampresource = message, operation = delete

Message → Get Thread Replies​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Channel IDchannelIdstringYes''Channel IDresource = message, operation = getReplies
Thread TimestampthreadTsstringYes''Thread Timestampresource = message, operation = getReplies
LimitlimitnumberNo100Number of itemsresource = message, operation = getReplies
OutputoutputoptionsNosimpleSimple (simple), Raw (raw)resource = message, operation = getReplies
CursorcursorstringNo''Pagination cursorresource = message, operation = getReplies
PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Channel IDchannelIdstringYes''Channel IDresource = message, operation = getPermalink
Message TimestampmessageTsstringYes''Message Timestampresource = message, operation = getPermalink

Reaction → Add​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Channel IDchannelIdstringYes''Channel IDresource = reaction, operation = add
Message TimestampmessageTsstringYes''Message Timestampresource = reaction, operation = add
EmojiemojistringYes''Emoji name (e.g. thumbsup)resource = reaction, operation = add

Reaction → Remove​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Channel IDchannelIdstringYes''Channel IDresource = reaction, operation = remove
Message TimestampmessageTsstringYes''Message Timestampresource = reaction, operation = remove
EmojiemojistringYes''Emoji name (e.g. thumbsup)resource = reaction, operation = remove

User → Get by Email​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
EmailemailstringYes''Email addressresource = user, operation = getByEmail
OutputoutputoptionsNosimpleSimple (simple), Raw (raw)resource = user, operation = getByEmail

User → Get Many​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
LimitlimitnumberNo100Number of itemsresource = user, operation = getMany
OutputoutputoptionsNosimpleSimple (simple), Raw (raw)resource = user, operation = getMany
CursorcursorstringNo''Pagination cursorresource = user, operation = getMany

User → Get Profile​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
UseruserstringNo''User IDresource = user, operation = getProfile

User → Update Profile​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
UseruserstringNo''User IDresource = user, operation = updateProfile
Clear StatusclearStatusbooleanNofalsetrue / falseresource = user, operation = updateProfile
Status Textstatus_textstringNo''Status textresource = user, operation = updateProfile
Status Emojistatus_emojistringNo''Status emojiresource = user, operation = updateProfile
Status Expirationstatus_expirationstringNo''Status expiration (Unix timestamp)resource = user, operation = updateProfile
First Namefirst_namestringNo''First nameresource = user, operation = updateProfile
Last Namelast_namestringNo''Last nameresource = user, operation = updateProfile
EmailemailstringNo''Email addressresource = user, operation = updateProfile

Channel → Get Many​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Channel TypeschannelTypesoptionsNopublicAndPrivatePublic (public), Private (private), Public and Private (publicAndPrivate), Direct Messages (directMessages), Group Direct Messages (groupDirectMessages), All (all)resource = channel, operation = getMany
Exclude ArchivedexcludeArchivedbooleanNofalsetrue / falseresource = channel, operation = getMany
LimitlimitnumberNo100Number of itemsresource = channel, operation = getMany
OutputoutputoptionsNosimpleSimple (simple), Raw (raw)resource = channel, operation = getMany
CursorcursorstringNo''Pagination cursorresource = channel, operation = getMany

Channel → Create​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Channel NamechannelNamestringYes''Channel nameresource = channel, operation = create
Is PrivateisPrivatebooleanNofalsetrue / falseresource = channel, operation = create

Channel → Archive​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Channel IDchannelIdstringYes''Channel IDresource = channel, operation = archive

Channel → Set Topic​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Channel IDchannelIdstringYes''Channel IDresource = channel, operation = setTopic
TopictopicstringYes''Topic textresource = channel, operation = setTopic

Channel → Invite People​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Channel IDchannelIdstringYes''Channel IDresource = channel, operation = invite
User IDsuserIdsstringYes''Comma-separated User IDsresource = channel, operation = invite

Channel → Remove Person​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Channel IDchannelIdstringYes''Channel IDresource = channel, operation = remove
User IDuserIdstringYes''User IDresource = channel, operation = remove

File → Upload​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Binary Property NamebinaryPropertyNamestringYesdataName of the binary propertyresource = file, operation = upload
Channel IDchannelIdstringNo''Channel IDresource = file, operation = upload
Upload OptionsuploadOptionsobjectNo{}Collection (Filename, Title, Initial Comment, Thread Timestamp, Alt Text)resource = file, operation = upload

File → Get Info​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
File IDfileIdstringYes''File IDresource = file, operation = getInfo
OutputoutputoptionsNosimpleSimple (simple), Raw (raw)resource = file, operation = getInfo

File → Download​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
File IDfileIdstringYes''File IDresource = file, operation = download
Binary Property NamebinaryPropertyNamestringYesdataName of the binary propertyresource = file, operation = download

Search → Messages / Files​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
QueryquerystringYes''Search queryresource = search
CountcountnumberNo100Number of itemsresource = search
PagepagenumberNo1Page numberresource = search
SortsortoptionsNoscoreScore (score), Timestamp (timestamp)resource = search
Sort Directionsort_diroptionsNodescAscending (asc), Descending (desc)resource = search

Interaction → Respond​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Response URLresponseUrlstringYes''Response URLresource = interaction, operation = respond
Message TexttextstringNo''Free textresource = interaction, operation = respond
BlocksblocksjsonNo[]JSON array of Slack Block Kit blocksresource = interaction, operation = respond
Replace OriginalreplaceOriginalbooleanNofalsetrue / falseresource = interaction, operation = respond
Response TyperesponseTypeoptionsNoin_channelIn Channel (in_channel), Ephemeral (ephemeral)resource = interaction, operation = respond

Notes​

  • Channel/User and Message Text are both required for sending messages; if either is empty the node errors before sending.
  • Output: { success, channel, timestamp, message: { text, ts, user, bot_id, bot_name, thread_ts } } for message sending.
  • Pagination/Cursors: Operations like listScheduled, getReplies, getMany (users/channels) support pagination via limit and cursor.
  • Binary File Handling: The File → Upload and File → Download operations use the binaryPropertyName to read from or write to the workflow's binary data.
  • Response URL: The Interaction → Respond operation uses the responseUrl provided by Slack interaction payloads (e.g., from the Slack Interactions Trigger) to send a response back to the user.