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.