Skip to main content

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 the message 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, or file_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.