Slack

with slack modules in make, you can create, update, delete, retrieve, watch, and/or search for messages, files, channels, reactions, users, reminders, and/or statuses to get started with slack, create an account at slack com/getting started refer to the slack api documentation for the list of available endpoints slack terminology private channel formerly group direct message formerly im channel referred to as conversation in the api documentation and channel in the slack application connect slack to {{product name}} to establish the connection log in to your make account, add a slack module to your {{scenario singular lowercase}} , and click create a connection note if you add a module with an instant tag, click create a webhook , then create a connection depending on the module you add, you may be prompted to choose the connection type slack (user) or slack (bot) if not, continue to step 4 note slack watch modules only function with user connections at this time if you would like to create a webhook with an interactive bot, you must use the webhooks docid 1yhunj8jvzyxip9cf3ps1 module optional in the connection name field, enter a name for the connection optional click show advanced settings and enter your custom app client credentials or add additional scopes to create client credentials, see the slack docid\ jkku9jb2cdm3ygxrdr2pi section click save if prompted, authenticate your account if your account has multiple slack workspaces, select the relevant workspace in the top right corner and grant access to make you have successfully established the connection you can now edit your {{scenario singular lowercase}} and add more slack modules if your connection requires reauthorization at any point, follow the connection renewal steps here note some modules may require additional permissions extension if so, you will be asked to authorize the required permissions create custom app and client credentials in slack to create a custom app and client credentials log in to your slack account and go to the your apps page click create new app select from scratch enter a name for your app, select a workspace, and click create app this brings you to the basic information page of your new app scroll down to the app credentials section copy your client id and store it in a safe place in the client secret field, click show , copy your secret, and store it in a safe place in the left sidebar, click oauth & permissions scroll down to the redirect urls section, click add new redirect url , enter the redirect url listed below for user and/or bot , and click add > save urls user https //www integromat com/oauth/cb/slack2 bot https //www integromat com/oauth/cb/slack3 in the scopes section, add bot token scopes or user token scopes you can add scopes for both types to one custom app click add an oauth scope and select scopes in the dropdown menu repeat this for all desired scopes for a list of required scopes for each module, see the scopes list below note if you change permission scopes in your slack app after creation, you will be prompted in the slack my apps pages to reinstall your app you now have the client credentials to connect to make messages you can watch public and private channel messages, watch direct and multiparty direct messages, watch scheduled messages, search for messages, list scheduled messages, retrieve private and public channel messages, list replies, create, update, schedule, and delete a message using the following modules watch public channel messages triggers when a new message is added to a public channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi input method select the input method select from a list search by the name public channel select or map a public channel whose messages you want to watch public channel enter (map) a public channel name whose messages you want to watch limit set the maximum number of public channel messages make will return during one execution cycle the default value is 2 watch private channel messages triggers when a new message is added to a private channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi input method select the input method select from a list search by the name private channel select or map a private channel whose messages you want to watch private channel enter (map) a private channel name whose messages you want to watch limit set the maximum number of private channel messages make will return during one execution cycle the default value is 2 watch direct messages triggers when a new direct message is added to a direct message channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi input method select the input method select from a list search by the name direct message select or map a direct message you want to watch direct message enter (map) a direct message channel name whose messages you want to watch alternatively, you can search for a direct message channel name enter (map) a name to search for a multiparty direct message exclude archived select whether to exclude the archived channels limit set the maximum number of direct messages make will return during one execution cycle the default value is 2 watch multiparty direct messages triggers when a new message is added to a multiparty direct message channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi input method select the input method select from a list search by the name direct message to multiple people select or map a multiple direct message channel whose messages you want to watch direct message to multiple people enter (map) a multiple direct message name whose messages you want to watch alternatively, you can search for a direct message channel name enter (map) a name to search for a direct message exclude archived select whether to exclude the archived channels limit set the maximum number of multiparty direct messages make name will return during one execution cycle the default value is 2 search for message returns messages matching a search query connection slack docid\ jkku9jb2cdm3ygxrdr2pi query enter the search term you want to search the workspace for see search in slack https //get slack help/hc/en us/articles/202528808 search in slack for a list of search modifiers limit set the maximum number of messages make will return during one execution cycle the default value is 2 sort by select a parameter to sort score timestamp direction select the sorting direction ascending descending get a private channel message returns a message with a given id from a specified private channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi input method select the input method select from a list search by the name private channel select or map a private channel whose messages you want to retrieve private channel enter (map) a private channel name whose messages you want to retrieve alternatively, you can search for a public channel name enter (map) the channel name to search exclude archived select whether to exclude the archived channels message id (timestamp) enter (map) a message id of a message to retrieve get a public channel message returns a message with a given id from a specified public channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi input method select the input method select from a list select from a list public channel select or map a public channel whose messages you want to retrieve public channel enter (map) a public channel name whose messages you want to retrieve alternatively, you can search for a public channel name enter (map) the channel name to search exclude archived select whether to exclude the archived channels message id (timestamp) enter (map) a message id of a message to retrieve list replies retrieves a thread messages posted to a conversation connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel type select the channel type public channel private channel direct message direct message to multiple people public channel select or map a public channel whose message you want to create private channel select or map a private channel whose message you want to create direct message select or map a user whose message you want to create direct message to multiple select or map a direct message to multiple people and list the replies parent message id (timestamp) enter (map) a parent message id of a message whose replies you want to list limit set the maximum number of replies make will return during one execution cycle the default value is 2 create a message creates a new message connection slack docid\ jkku9jb2cdm3ygxrdr2pi enter a channel id or name select the input method enter manually select from the list channel id or name enter (map) a channel id or name whose message you want to create note you must specify a public channel, private channel, or a direct message channel you can either pass the channel's name (#general) or encoded id (c0123be12l) channel type select the channel type public channel private channel direct message direct message to multiple people public channel select or map a public channel whose message you want to create private channel select or map a private channel whose message you want to create direct message select or map a direct message channel whose message you want to create direct message to multiple people select or map a multiple direct message channel whose message you want to create text enter (map) the text content of the message you want to create for detailed information about text formatting, please refer to the slack documentation blocks enter (map) the blocks to be combined with messages to create visually rich and compellingly interactive messages for detailed information about text formatting, please refer to the slack documentation thread message id (timestamp) enter (map) another message's time stamp value to make this message a reply avoid using a reply's time stamp value; use its parent instead reply broadcast select whether they should be made visible to everyone in the channel or conversation note used in conjunction with the thread message id link names names and channels will not be linkified in the @username or #channel format unless you enable this option for more information, refer to the formatting spec https //api slack com/docs/formatting parse message text select whether to parse the message text note defines how messages are treated use markdown disable slack markup parsing by selecting the no option unfurl primarily text based content enable this option to enable the unfurling of primarily text based content for detailed information about unfurling in slack, refer to the unfurling links in the messages https //api slack com/docs/message link unfurling article unfurl media content disable this option to disable the unfurling of media content for detailed information about unfurling in slack, please refer to the unfurling links in the messages https //api slack com/docs/message link unfurling article icon emoji enter (map) an emoji to use as the icon for this message overrides icon url this field only has an effect when using a bot connection icon url enter (map) an icon url to an image to use as the icon for this message this field only has an effect when using a bot connection user name enter (map) a user name to create a message if not specified, the default bot name will be used this field only has an effect when using a bot connection update a message updates a message connection slack docid\ jkku9jb2cdm3ygxrdr2pi enter a channel id or name select the input method enter manually select from the list channel id or name enter (map) an updated channel id or name whose message you want to create you must specify a public channel, private channel, or a direct message you can either pass the channel's name (#general) or encoded id (c0123be12l) channel type select the channel type public channel private channel direct message direct message to multiple people public channel select or map a public channel whose message you want to create private channel select or map a private channel whose message you want to create direct message select or map a direct message whose message you want to create direct message to multiple people select or map a multiple direct message whose message you want to create timestamp (message id) enter (map) the message's time stamp value or the message id to whose text you want to update text enter (map) the text content of the message you want to create for detailed information about text formatting, please refer to the slack documentation blocks enter (map) the blocks to be combined with messages to create visually rich and compellingly interactive messages for detailed information about text formatting, please refer to the slack documentation link names names and channels will not be linkified in the @username or #channel format unless you enable this option for more information, refer to the formatting spec https //api slack com/docs/formatting parse message text select whether to parse the message text defines how messages are treated delete a message removes a message connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel id enter (map) a channel id of a channel whose messages you want to delete message id (timestamp) enter (map) a message id of a message to delete files you can watch, list, retrieve, download, upload, create and delete files using the following modules watch files triggers when a new file is added connection slack docid\ jkku9jb2cdm3ygxrdr2pi type select the file type for which you want to watch posts snippets google docs images zips pdfs channel type select the channel from which you want to filter the files public channel private channel direct message direct message to multiple people public channel select or map a public channel to watch the files private channel select or map a private channel to watch the files user select or map a user to watch the files direct message to multiple people select or map a direct message to multiple people and watch the files created by filter files to those created by the selected user limit set the maximum number of files make will return during one execution cycle the default value is 2 list files returns a list of files within a team connection slack docid\ jkku9jb2cdm3ygxrdr2pi type select the file type you want to retrieve posts snippets google docs images zips pdfs channel type select the channel from which to filter the files public channel private channel direct message direct message to multiple people public channel select or map a public channel to list the files private channel select or map a private channel to list the files user select or map a user to list the files direct message to multiple people select or map direct message to multiple people and list the files created by filter files created by the selected user date from set the start date from when you want to list the files date to set the end date until when you want to list the files limit set the maximum number of files make will return during one execution cycle the default value is 2 get a file returns details about a file connection slack docid\ jkku9jb2cdm3ygxrdr2pi file id enter (map) the id of the file you want to retrieve details about download a file downloads a file connection slack docid\ jkku9jb2cdm3ygxrdr2pi url private download enter (map) the url private download value from the get a file module upload a file creates or uploads a file connection slack docid\ jkku9jb2cdm3ygxrdr2pi channels enter (map) the channel's details channel type select the channel where you want to upload the file public channel private channel direct message direct message to multiple people file enter (map) a file details file name enter (map) the file name data enter (map) the file data title enter (map) the title of the file thread id (timestamp) enter (map) the thread id to upload the file as a reply initial comment enter (map) the message text introducing the file in the specified channel create a text file creates a text file connection slack docid\ jkku9jb2cdm3ygxrdr2pi channels enter (map) the channel's details channel type public channel private channel direct message direct message to multiple people public channel select or map a public channel to create a file private channel select or map a private channel to create a file user select or map a user to create a file direct message to multiple people select or map a direct message to multiple people and create a file file enter (map) a file details file name enter (map) the file name content enter (map) the file data title enter (map) the title of the file thread id (timestamp) enter (map) the thread id to create the file as a reply initial comment enter (map) the message text introducing the file in the specified channel delete a file deletes a file connection slack docid\ jkku9jb2cdm3ygxrdr2pi file id enter (map) the id of the file you want to delete channels you can list, retrieve, list members, set the topic, set the purpose, join a channel, leave a channel, create, archive, and unarchive a channel using this module list channels returns a list of channels in a workspace connection slack docid\ jkku9jb2cdm3ygxrdr2pi exclude archived select whether to exclude archived channels in the results type select the type of channels you want to retrieve public channel private channel direct message channel direct message to multiple people limit set the maximum number of channels make will return during one execution cycle the default value is 2 next cursor set the cursor parameter equal to the next cursor value you received on the last request to retrieve the next portion of the collection for information see the cursor based pagination https //api slack com/docs/pagination#cursors get a channel returns details about a channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel id enter (map) the channel id of the channel you want to retrieve list members in a channel returns users in the selected channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel type select the channel type public channel private channel public channel select or map a public channel whose members you want to list private channel select or map a private channel whose members you want to list limit set the maximum number of members make will return during one execution cycle the default value is 2 set the topic of a channel changes the topic of a channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel type select the channel type public channel private channel direct message direct message to multiple people input method select the input method select from a list search by the name public channel select or map a public channel whose topic you want to set private channel select or map a private channel whose topic you want to set direct message select or map a direct message whose topic you want to set direct message to people select or map a direct message to multiple people whose topic you want to set public channel enter (map) a public channel whose topic you want to set alternatively, you can search a channel name enter (map) a name to search exclude archived select whether to exclude the archived channels private channel enter (map) a private channel whose topic you want to set alternatively, you can search a channel name enter (map) a name to search exclude archived select whether to exclude the archived channels direct message enter (map) a public channel whose topic you want to set alternatively, you can search a channel name enter (map) a name to search exclude archived select whether to exclude the archived channels direct message to multiple people enter (map) a public channel whose topic you want to set alternatively, you can search a channel name enter (map) a name to search exclude archived select whether to exclude the archived channels topic enter (map) the topic name for the channel does not support formatting or linkification for example, apply topically for best effects set the purpose of a channel changes the purpose of a channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel type select the channel type public channel private channel direct message direct message to multiple people input method select the input method select from a list search by the name public channel select or map a public channel whose purpose you want to set private channel select or map a private channel whose purpose you want to set direct message select or map a direct message whose purpose you want to set direct message to multiple people select or map a direct message to multiple people whose purpose you want to set public channel enter (map) a public channel whose purpose you want to set alternatively, you can search a channel name enter (map) a name to search exclude archived select whether to exclude the archived channels private channel enter (map) a private channel whose purpose you want to set alternatively, you can search a channel name enter (map) a name to search exclude archived select whether to exclude the archived channels direct message enter (map) a public channel whose purpose you want to set alternatively, you can search a channel name enter (map) a name to search exclude archived select whether to exclude the archived channels direct message to multiple people enter (map) a public channel whose purpose you want to set alternatively, you can search a channel name enter (map) a name to search exclude archived select whether to exclude the archived channels purpose enter (map) the new special purpose for the channel for example, my more special purpose join a channel joins to an existing channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel id enter (map) the channel id of a channel you want to join leave a channel leaves a channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel id enter (map) the channel id of a channel you want to leave create a channel creates a channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi name enter (map) the name of the public or private channel to create is private select whether the channel is private archive a channel archives a channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel id enter (map) the channel id of the channel you want to archive unarchive a channel unarchives a channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel id enter (map) the channel id of the channel you want to unarchive reactions you can list, add, and remove a reaction using the following modules list reactions returns reactions a user made connection slack docid\ jkku9jb2cdm3ygxrdr2pi user select or map a user whose reactions you want to list limit set the maximum number of reactions make should return during one execution cycle the default value is 2 add a reaction adds a reaction to an item connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel type select the channel type public channel private channel direct message direct message to multiple people public channel select or map a public channel to whose message you want to add a reaction for example, c1234567890 private channel select or map a private channel to whose message you want to add a reaction for example, c1234567894 user select or map a user to whose message you want to add a reaction direct message to multiple people select or map a direct message to multiple people to whose message you want to add a reaction message id (timestamp) enter (map) the message id or a timestamp of the message to add a reaction for example, 1234567890 123456 reaction (emoji) name enter (map) the reaction (emoji) name for example, thumbsup remove a reaction removes a reaction connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel type select the channel type public channel private channel direct message direct message to multiple people public channel select or map a public channel to whose message you want to remove a reaction for example, c1234567890 private channel select or map a private channel to whose message you want to remove a reaction for example, c12345678904 user select or map a user to whose message you want to remove a reaction direct message to multiple people select or map a direct message to multiple people to whose message you want to remove a reaction message id (timestamp) enter (map) the message id or a timestamp of the message to add a reaction for example, 1234567890 123456 reaction (emoji) name enter (map) the reaction (emoji) name for example, thumbsup stars you can add and remove stars using the following modules add a star adds a star to a channel, message, file, or a file comment connection slack docid\ jkku9jb2cdm3ygxrdr2pi add a star to select whether you want to add a star to a channel, file, or file comment channel/file id/file comment id enter respective ids you can star a message by selecting a channel and entering the message timestamp remove a star removes a star from the channel, message, file, or a file comment connection slack docid\ jkku9jb2cdm3ygxrdr2pi add a star to select whether you want to remove the star from a channel, file, or file comment channel/file id/file comment id enter respective ids of the objects you want to remove the star from you can remove a star from the message by selecting a channel and entering the message timestamp saved items you can save an item and remove the saved item using the following modules save an item adds an item to saved items connection slack docid\ jkku9jb2cdm3ygxrdr2pi message id (timestamp) enter (map) a message id of a message whose item you want to save file id enter (map) a file id of a file to save remove saved item removes a saved item connection slack docid\ jkku9jb2cdm3ygxrdr2pi message id (timestamp) enter (map) a message id of a message whose item you want to remove file id enter (map) a file id of a file to remove pins you can pin and unpin a message using the following modules pin a message pins a message to a channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel type select the channel type public channel private channel direct message direct message to multiple people public channel select or map a public channel whose message you want to pin private channel select or map a private channel whose message you want to pin user select or map a user whose message you want to pin direct message to multiple people select or map a direct message to multiple people you want to pin message id (timestamp) enter (map) the timestamp of the message to pin for example, 1234567890 123456 unpin a message unpins a message from a channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel type select the channel type public channel private channel direct message direct message to multiple people public channel select or map a public channel whose message you want to unpin private channel select or map a private channel whose message you want to unpin user select or map a user whose message you want to unpin direct message to multiple people select or map a direct message to multiple people you want to unpin message id (timestamp) enter (map) the timestamp of the message to unpin for example, 1234567890 123456 users you can watch, search, list, retrieve, invite and kick a user using the following modules watch users triggers when a new user is added or an existing user has changed only emit the latest change since the last scenario run connection slack docid\ jkku9jb2cdm3ygxrdr2pi limit set the maximum number of users make will return during one execution cycle the default value is 2 when setting the schedule to run your watch slack users scenario, the advanced scheduling option to choose a start date is restricted to slack users with a premium account search for user retrieves a single user by looking them up by their registered email address connection slack docid\ jkku9jb2cdm3ygxrdr2pi email enter the email address of the user you want to search for list users returns a list of all users in a workspace connection slack docid\ jkku9jb2cdm3ygxrdr2pi limit set the maximum number of users make will return during one cycle the default value is 2 get a user returns details about a member to a workspace connection slack docid\ jkku9jb2cdm3ygxrdr2pi user id enter (map) the user id of the user you want to retrieve information about invite users invites 1 30 users to a public or private channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel type select the channel type public channel private channel public channel select or map a public channel to add the users private channel select or map a private channel to add the users users select the users you want to add to the channel kick a user removes a user from a channel connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel type select the channel type public channel private channel public channel select or map a public channel whose user you want to remove private channel select or map a private channel whose user you want to remove users select the user you want to remove from the channel reminders you can list, retrieve, create, complete, and delete a reminder using the following modules list reminders lists all reminders created by or for a given user connection slack docid\ jkku9jb2cdm3ygxrdr2pi limit set the maximum number of reminders make will return during one execution cycle the default value is 2 get a reminder returns details about a reminder connection slack docid\ jkku9jb2cdm3ygxrdr2pi reminder id enter (map) the id of the reminder you want to retrieve information about for example, rm12345678 create a reminder creates a reminder connection slack docid\ jkku9jb2cdm3ygxrdr2pi text enter (map) the content to appear in the reminder time enter (map) the time when this reminder should happen enter the unix timestamp (up to five years from now), the number of seconds until the reminder (if within 24 hours), or a natural language description for example, in 15 minutes every thursday user select or map the user you want to create a reminder for complete a reminder completes a reminder connection slack docid\ jkku9jb2cdm3ygxrdr2pi reminder id enter (map) the id of the reminder you want to mark as complete for example, rm12345678 delete a reminder removes a reminder connection slack docid\ jkku9jb2cdm3ygxrdr2pi reminder id enter (map) the id of the reminder you want to delete for example, rm12345678 events you can watch new events using the following module new event triggers when a new message or other events are created webhook name enter (map) a name for the webhook event type select the event type new channel message new private channel message new im message new mp im message new reaction new file connection slack docid\ jkku9jb2cdm3ygxrdr2pi channel select or map a channel whose event you want to watch profile you can set a status in events using the following module set a status update a user’s current status connection slack docid\ jkku9jb2cdm3ygxrdr2pi status text enter (map) the status text you can enter up to 100 characters status emoji enter (map) the status emojis enabled for the slack team for example, \ train the list of possible emojis can be found in the slack emoji cheat sheet https //www webfx com/tools/emoji cheat sheet/ status expiration enter (map) the unix timestamp of when the status will expire providing 0 or omitting this field results in a custom status that will not expire other make an api call performs an arbitrary authorized api call connection slack docid\ jkku9jb2cdm3ygxrdr2pi url enter a path relative to https //slack com/api/ https //slack com/api/ for example /list conversations for the list of available endpoints, refer to the slack api documentation method get to retrieve information for an entry post to create a new entry put to update/replace an existing entry patch to make a partial entry update delete to delete an entry headers enter the desired request headers you don't have to add authorization headers; we already did that for you query string enter the request query string body enter the body content for your api call scopes add a reaction channels\ read, groups\ read, im\ read, mpim\ read, reactions\ write add a star stars\ write, channels\ read, groups\ read, im\ read, mpim\ read archive a channel channels\ write, groups\ write, im\ write, mpim\ write complete a reminder reminders\ write create a channel users\ read, channels\ write, groups\ write create a message chat\ write, chat\ write public, chat\ write customize, channels\ read, groups\ read, im\ read, mpim\ read, users\ read create a reminder reminders\ write, users\ read create a text file files\ write, channels\ read, groups\ read, im\ read, mpim\ read, files\ read create a text file (deprecated) files\ write, channels\ read, groups\ read, im\ read, mpim\ read delete a file files\ write delete a message chat\ write delete a reminder reminders\ write disable do not disturb mode dnd\ write disable snooze mode dnd\ write download a file files\ read enable do not disturb mode dnd\ write get a channel channels\ read, groups\ read, im\ read, mpim\ read get a file files\ read get a private channel message groups\ history get a private channel message v2 groups\ history get a public channel message channels\ history get a reminder reminders\ read get a user users\ read, users\ read email get a user's do not disturb status dnd\ read, users\ read get my info identity basic invite a user to workspace admin users\ write, admin teams\ read, admin conversations\ read invite users channels\ write, channels\ read, groups\ write, groups\ read, im\ writeim\ read, mpim\ writemp, im\ read, users\ read join a channel channels\ write kick a user channels\ write, channels\ read, groups\ write, groups\ read, im\ write, im\ read, mpim\ write, mpim\ read, users\ read leave a channel channels\ write, groups\ write, im\ write, mpim\ write list channels channels\ read, groups\ read, im\ read, mpim\ read list files files\ read, channels\ read, groups\ read, users\ read, im\ read, mpim\ read list members in a channel channels\ read, groups\ read, im\ read, mpim\ read list reactions reactions\ read, users\ read list reminders reminders\ read list replies channels\ read, groups\ read, im\ read, mpim\ read, channels\ history, groups\ history, im\ history, mpim\ history list saved items stars\ read list scheduled messages channels\ read, groups\ read, im\ read, mpim\ read, users\ read list users users\ read, users\ read email new event channels\ read, emoji\ read, files\ read, channels\ read, groups\ read, channels\ history, groups\ history, im\ history, mpim\ history, reactions\ read open a conversation im\ write, mpim\ write, users\ read pin a message pins\ write remove a reaction channels\ read, groups\ read, im\ read, mpim\ read, reactions\ write remove a star stars\ write remove saved item stars\ write save an item stars\ write, channels\ read, groups\ read, im\ read, mpim\ read schedule a message chat\ write, chat\ write public, chat\ write customize, channels\ read, groups\ readim\ read, mpim\ read, users\ read search for message search\ read search for user users\ read, users\ read email set a status users profile\ write set the purpose of a channel channels\ read, groups\ read, im\ read, mpim\ read, channels\ write, groups\ write, im\ write, mpim\ write set the topic of a channel channels\ read, groups\ read, im\ read, mpim\ read, channels\ write, groups\ write, im\ write, mpim\ write unarchive a channel channels\ write, groups\ write, im\ write, mpim\ write unpin a message pins\ write update a message chat\ write, channels\ read, groups\ read, im\ read, mpim\ read, users\ read upload a file files\ write, channels\ read, groups\ read, im\ read, mpim\ read, files\ read upload a file (deprecated) files\ write, channels\ read, groups\ read, im\ read, mpim\ read watch direct messages im\ history, im\ read, users\ read watch files files\ read, channels\ read, groups\ read, users\ read, im\ read, mpim\ read watch multiparty direct messages mpim\ history, mpim\ read watch private channel messages groups\ history, groups\ read watch private channel messages v2 groups\ history, groups\ read watch public channel messages channels\ history, channels\ read watch saved items stars\ read watch scheduled messages channels\ read, groups\ read, im\ read, mpim\ read, users\ read watch starred messages stars\ read watch users users\ read