Skip to main content

Notification Tasks

Send messages via email, Slack, Microsoft Teams, and Google Chat.

notifications.email​

Display Name: Send Email

Send an email to one or more recipients.

Parameters​

NameTypeRequiredDescription
recipientsarrayYesEmail addresses to send to. Supports dynamic selection from onboarded users.
subjectstringYesEmail subject line.
bodystringYesEmail body content (HTML or plain text).
reply_tostringNoReply-to email address.

Output​

NameTypeDescription
successbooleanWhether the email was sent successfully.
sent_toarrayList of recipients the email was delivered to.

notifications.im​

Display Name: Send IM

Send a message to a Slack channel, MS Teams channel, or Google Chat space.

Parameters​

NameTypeRequiredDescription
providerstringYesIM platform. Options: slack, ms_teams, google_chat.
team_idstringNoTeam ID (required for MS Teams).
channelstringYesChannel ID or name to post in.
messagestringYesMessage body (supports markdown for Slack).
message_thread_idstringNoThread ID to reply within a thread instead of posting a new message.

Output​

NameTypeDescription
channelstringChannel where the message was posted.
message_idstringID of the sent message (use as message_thread_id for follow-ups).
teamstringTeam ID.
platformstringPlatform used.

notifications.dm​

Display Name: DM

Send a direct message to a specific user.

Parameters​

NameTypeRequiredDescription
providerstringYesIM platform. Options: slack.
user_idstringYesUser ID to send the message to.
messagestringYesMessage body.

Output​

NameTypeDescription
user_idstringTarget user ID.
channel_idstringDM channel ID.
message_idstringMessage ID.
providerstringPlatform used.

notifications.read_thread​

Display Name: Read Thread Messages

Fetch replies and reactions from a Slack thread. Useful for checking if someone responded to a notification.

Parameters​

NameTypeRequiredDescription
providerstringYesOnly slack is currently supported.
channel_idstringYesChannel ID where the thread exists.
thread_tsstringYesThread timestamp (parent message ts).
team_idstringNoWorkspace ID (optional if tenant has a single workspace).

Output​

NameTypeDescription
successbooleanWhether the request succeeded.
messagesarrayMessages in the thread (includes reactions).
reply_countnumberNumber of replies.
has_responsesbooleanTrue if there are replies or reactions.
has_reactionsbooleanTrue if the parent message has reactions.
has_morebooleanWhether there are more messages to fetch.

notifications.add_reaction​

Display Name: Add Reaction

Add an emoji reaction to a message on Slack, MS Teams, or Google Chat.

Parameters​

NameTypeRequiredDescription
providerstringYesPlatform. Options: slack, ms_teams, google_chat.
team_idstringNoTeam ID (required for MS Teams).
channel_idstringYesChannel or space ID.
message_idstringYesMessage timestamp (Slack) or message ID (Teams/Chat).
emojistringYesEmoji to add. Slack: name without colons (e.g., thumbsup). Teams/Chat: unicode (e.g., 👍).

Output​

NameTypeDescription
successbooleanWhether the reaction was added.

slack.join_channel​

Display Name: Slack Join Channel

Add the bot to a public Slack channel so it can post messages there.

Parameters​

NameTypeRequiredDescription
channel_idstringYesThe ID of the public Slack channel to join.
textstringNoOptional message to send upon joining.

Output​

NameTypeDescription
responseobjectRaw response from the Slack API.