Slack event types
Learn about different types of Slack events, the parameters they take and their root conditions.
Info
All Slack workflows require a Slack connection.
Caution
Name of user referred in a root condition field is the real name a of Slack user, not the display name.
New channel created
Triggers when a new #channel is created.
Parameters
- This event does not take any parameters.
Root conditions
- Channel name: Name of the channel that is created. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
- Creator user: User that created the channel. Can be filtered through a dropdown. Values are the list of users in the connected Slack workspace.
- Creator user name: Real name of the user that created the channel. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
Example event payload
{
"creator_user":{
"id":"U123456789",
"display_name":"Joe",
"real_name":"Joe Doe",
"email":"joe@hitchhikers.com",
"picture_url":"https://.../avatar/e3b51ca72dee4ef87916ae2b9240df50.jpg"
},
"channel":{
"id":"C12345678",
"name":"channel123",
"type":"PUBLIC"
},
"event_time_utc_millis":1608284197000015,
"slack_workspace":{
"id":"T123456789",
"name":"hitchhikers"
}
}
creator_user
object indicates the user that created the channel.channel
object indicates channel that is created.event_time_utc_millis
property indicates the event's occurance time in UTC milliseconds.slack_workspace
object indicates the connected Slack workspace.
Member joined a channel
Triggers when a user joins a #channel you select.
Parameters
- Channel (optional): Channel that the workflow will listen member joined events for.
Root conditions
- Channel name: Name of the channel that a member joined. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
- Channel: Channel that a member joined. Can be filtered through a dropdown. Values are the list of public channels in the connected Slack workspace.
- Inviter user: User that invited the member who joined the channel. Can be filtered through a dropdown. Values are the list of users in the connected Slack workspace.
- Inviter user name: Real name of the user that invited the member who joined the channel. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
- Member joined: Member that joined to the channel. Can be filtered through a dropdown. Values are the list of users in the connected Slack workspace.
- Name of the member who joined: Name of the member that joined to the channel. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
Example event payload
{
"user_joined":{
"id":"U123456789",
"display_name":"Joe",
"real_name":"Joe Doe",
"email":"joe@hitchhikers.com",
"picture_url":"https://.../avatar/e3b51ca72dee4ef87916ae2b9240df50.jpg"
},
"user_inviter":{
"id":"U12345",
"display_name":"Jane",
"real_name":"Jane Doe",
"email":"jane@hitchhikers.com",
"picture_url":"https://.../avatar/e3b51ca72dee4ef87916ae2b9240df50.jpg"
},
"channel":{
"id":"C12345678",
"name":"channel123",
"type":"PUBLIC"
},
"event_time_utc_millis":1608284197000015,
"slack_workspace":{
"id":"T123456789",
"name":"hitchhikers"
}
}
user_joined
object indicates the member that joined a channel.user_inviter
object indicates the member who invited the user that joined the channel. The object will be absent when a user manually joins a channel, or a user is added by default (e.g. #general channel).channel
object indicates the channel that a member joined.event_time_utc_millis
property indicates the event's occurance time in UTC milliseconds.slack_workspace
object indicates the connected Slack workspace.
Member left a channel
Triggers when a user leaves a #channel you select.
Parameters
- Channel (optional): Channel that the workflow will listen member left events for.
Root conditions
- Channel name: Name of the channel that a member left. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
- Channel: Channel that a member left. Can be filtered through a dropdown. Values are the list of public channels in the connected Slack workspace.
- Member left: Member that left the channel. Can be filtered through a dropdown. Values are the list of users in the connected Slack workspace.
- Name of the member who left: Name of the member that left the channel. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
Example event payload
{
"user_left":{
"id":"U123456789",
"display_name":"Joe",
"real_name":"Joe Doe",
"email":"joe@hitchhikers.com",
"picture_url":"https://.../avatar/e3b51ca72dee4ef87916ae2b9240df50.jpg"
},
"channel":{
"id":"C12345678",
"name":"channel123",
"type":"PUBLIC"
},
"event_time_utc_millis":1608284197000015,
"slack_workspace":{
"id":"T123456789",
"name":"hitchhikers"
}
}
user_left
object indicates the member that left the channel.channel
object indicates the channel that member left.event_time_utc_millis
property indicates the event's occurance time in UTC milliseconds.slack_workspace
object indicates the connected Slack workspace.
Pin added
Triggers when a message is pinned to a #channel you select.
Parameters
- Channel (optional): Channel that the workflow will listen pin added events for.
Root conditions
- Channel name: Name of the channel that a pin was added. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
- Channel: Channel that a pin was added. Can be filtered through a dropdown. Values are the list of public channels in the connected Slack workspace.
- User added pin: User that added a pin to an item. Can be filtered through a dropdown. Values are the list of users in the connected Slack workspace.
- Name of the user who added pin: Real name of the user that added a pin to an item. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
- User who sent the message: User that posted the message which a pin was added to. Can be filtered through a dropdown. Values are the list of users in the connected Slack workspace.
- Message: Content of the message that a pin was added to. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
Example event payload
{
"item":{
"createdBy":"U12345",
"message":{
"text":"a message",
"permalink":"https://hitchhikers.slack.com/archives/C12345678/1508284197.000015",
"ts":"1508284197.000015",
"user":"U12345",
"team":"T123456789",
"appId":"A12345"
}
},
"channel":{
"id":"C12345678",
"name":"channel123",
"type":"PUBLIC"
},
"event_time_utc_millis":1608284197000015,
"user":{
"id":"U123456789",
"display_name":"Joe",
"real_name":"Joe Doe",
"email":"joe@hitchhikers.com",
"picture_url":"https://.../avatar/e3b51ca72dee4ef87916ae2b9240df50.jpg"
},
"slack_workspace":{
"id":"T123456789",
"name":"hitchhikers"
}
}
item
object indicates the pinned message.channel
object indicates the channel that a pin is added to.user
object indicates the user that pinned an item.event_time_utc_millis
property indicates the event's occurance time in UTC milliseconds.slack_workspace
object indicates the connected Slack workspace.
Pin removed
Triggers when a pin is removed from a message in a #channel you select.
Parameters
- Channel (optional): Channel that the workflow will listen pin removed events for.
Root conditions
- Channel name: Name of the channel that a pin was removed from an item. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
- Channel: Channel that a pin was removed from an item. Can be filtered through a dropdown. Values are the list of public channels in the connected Slack workspace.
- User removed pin: User that removed a pin from an item. Can be filtered through a dropdown. Values are the list of users in the connected Slack workspace.
- Name of the user who removed pin: Real name of the user that removed a pin from an item. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
- User who sent the message: User that posted the message which a pin was removed from. Can be filtered through a dropdown. Values are the list of users in the connected Slack workspace.
- Message: Content of the message that a pin was removed from. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
Example event payload
{
"item":{
"createdBy":"U12345",
"message":{
"text":"a message",
"permalink":"https://hitchhikers.slack.com/archives/C12345678/1508284197.000015",
"ts":"1508284197.000015",
"user":"U12345",
"team":"T123456789",
"appId":"A12345"
}
},
"channel":{
"id":"C12345678",
"name":"channel123",
"type":"PUBLIC"
},
"event_time_utc_millis":1608284197000015,
"user":{
"id":"U123456789",
"display_name":"Joe",
"real_name":"Joe Doe",
"email":"joe@hitchhikers.com",
"picture_url":"https://.../avatar/e3b51ca72dee4ef87916ae2b9240df50.jpg"
},
"slack_workspace":{
"id":"T123456789",
"name":"hitchhikers"
}
}
item
object indicates the value of the unpinned message.channel
object indicates the channel that an item is unpinned.user
object indicates the user that unpinned an item.event_time_utc_millis
property indicates the event's occurance time in UTC milliseconds.slack_workspace
object indicates the connected Slack workspace.
Channel archived
Triggers when a #channel is archived.
Parameters
- Channel (optional): Channel that the workflow will listen archived event for.
Root conditions
- Channel name: Name of the channel that was archived. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
- Channel: Channel that was archived. Can be filtered through a dropdown. Values are the list of public channels in the connected Slack workspace.
- User archived channel: User that archived a channel. Can be filtered through a dropdown. Values are the list of users in the connected Slack workspace.
- Name of the user who archived channel: Real name of the user that archived a channel. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
Example event payload
{
"channel":{
"id":"C12345678",
"name":"channel123",
"type":"PUBLIC"
},
"event_time_utc_millis":1608284197000015,
"user":{
"id":"U123456789",
"display_name":"Joe",
"real_name":"Joe Doe",
"email":"joe@hitchhikers.com",
"picture_url":"https://.../avatar/e3b51ca72dee4ef87916ae2b9240df50.jpg"
},
"slack_workspace":{
"id":"T123456789",
"name":"hitchhikers"
}
}
channel
object indicates the archived channel.user
object indicates the user that archived a channel.event_time_utc_millis
property indicates the event's occurance time in UTC milliseconds.slack_workspace
object indicates the connected Slack workspace.
Channel unarchived
Triggers when a channel is unarchived.
Parameters
- Channel (optional): Channel that the workflow will listen unarchived event for.
Root conditions
- Channel name: Name of the channel that was unarchived. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
- Channel: Channel that was unarchived. Can be filtered through a dropdown. Values are the list of public channels in the connected Slack workspace.
- User unarchived channel: User that unarchived a channel. Can be filtered through a dropdown. Values are the list of users in the connected Slack workspace.
- Name of the user who unarchived channel: Real name of the user that unarchived a channel. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
Example event payload
{
"channel":{
"id":"C12345678",
"name":"channel123",
"type":"PUBLIC"
},
"event_time_utc_millis":1608284197000015,
"user":{
"id":"U123456789",
"display_name":"Joe",
"real_name":"Joe Doe",
"email":"joe@hitchhikers.com",
"picture_url":"https://.../avatar/e3b51ca72dee4ef87916ae2b9240df50.jpg"
},
"slack_workspace":{
"id":"T123456789",
"name":"hitchhikers"
}
}
channel
object indicates the unarchived channel.user
object indicates the user that unarchived a channel.event_time_utc_millis
property indicates the event's occurance time in UTC milliseconds.slack_workspace
object indicates the connected Slack workspace.
New message posted
Triggers when a new message is posted to a #channel you select.
Parameters
- Channel (mandatory): Channel that the workflow will listen new message posted events for. Can be set as static or prefixed. Static values are the list of public channels in the connected Slack workspace. If you provide a prefix, Actioner listens events from public channels that their name starts with that prefix.
Root conditions
- Message: Content of the message that is posted. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
- User who sent message: User that posted a new message. Can be filtered through a dropdown. Values are the list of users in the connected Slack workspace.
- Name of the user who sent message: Real name of the user that posted a new message. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
- Parent message ts: Timestamp of the parent message. Can be empty if the new message is sent directly to the channel. If the new message is sent as a thread reply, it takes a unique value.
Example event payload
Info
- Detect a threaded message by looking for a
parentMessageTs
value in themessage
object. The existence of such a value indicates that the message is part of a thread. messageTs
indicates the timestamp of the message (sent to channel or sent as a thread reply).parentMessageTs
indicates the timestamp of the parent message that the thread reply is added to.
{
"channel":{
"id":"C12345678",
"name":"channel123",
"type":"PUBLIC"
},
"event_time_utc_millis":1608284197000015,
"message":{
"text":"a message",
"messageTs":"1508284197.000015"
},
"author_user":{
"id":"U123456789",
"display_name":"Joe",
"real_name":"Joe Doe",
"email":"joe@hitchhikers.com",
"picture_url":"https://.../avatar/e3b51ca72dee4ef87916ae2b9240df50.jpg"
},
"slack_workspace":{
"id":"T123456789",
"name":"hitchhikers"
}
}
channel
object indicates the channel that a new message is posted to.message
object indicates the posted message.author_user
object indicates the user that posted the message.event_time_utc_millis
property indicates the event's occurance time in UTC milliseconds.slack_workspace
object indicates the connected Slack workspace.
Emoji added
Triggers when a member adds the selected emoji reaction to an item in a public #channel.
Parameters
- Channel (mandatory): Channel that the workflow will listen emoji added events for. Can be set as static or dynamic. Static values are the list of public channels in the connected Slack workspace. If you provide a prefix, Actioner listens events from public channels that their name starts with that prefix.
- Emoji (optional): Emoji that the workflow will listen for.
Root conditions
- Message: Content of the message that an emoji is added to. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
- Reacted item type: Type of the item that an emoji is added to. Can be
message
,file
, orfile_comment
. - User who added emoji: User that added an emoji to an item. Can be filtered through a dropdown. Values are the list of users in the connected Slack workspace.
- Name of the user who added emoji: Real name of the user that added an emoji to an item. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
- User who sent message: User that posted the message which an amoji was added to. Can be filtered through a dropdown. Values are the list of users in the connected Slack workspace.
- Name of the user who sent message: Real name of the user that posted the message which an amoji was added to. Can be filtered through a freeform text. Expected value can be set as static or dynamic.
Example event payload
{
"reaction":"fire",
"item_type":"message",
"channel":{
"id":"C12345678",
"name":"channel123",
"type":"PUBLIC"
},
"event_time_utc_millis":1608284197000015,
"user_author":{
"id":"U12345",
"display_name":"Jane",
"real_name":"Jane Doe",
"email":"Jane@hitchhikers.com",
"picture_url":"https://.../avatar/e3b51ca72dee4ef87916ae2b9240df50.jpg"
},
"message":{
"text":"a message",
"messageTs":"1508284197.000015",
"messagePermalink":"https://hitchhikers.slack.com/archives/C12345678/1508284197.000015"
},
"slack_workspace":{
"id":"T123456789",
"name":"hitchhikers"
},
"user_reacted":{
"id":"U123456789",
"display_name":"Joe",
"real_name":"Joe Doe",
"email":"joe@hitchhikers.com",
"picture_url":"https://.../avatar/e3b51ca72dee4ef87916ae2b9240df50.jpg"
}
}
reaction
property indicates the emoji added.item_type
property indicates the type of the item that the selected emoji is added to.user_author
object indicates the user that created the original message.user_reacted
object indicates the user that added the selected emoji.message
object indicates the message that the emoji is added to.event_time_utc_millis
property indicates the event's occurance time in UTC milliseconds.slack_workspace
object indicates the connected Slack workspace.