diff --git a/source/_integrations/slack.markdown b/source/_integrations/slack.markdown
index 31a40fb9cce..f8fa9ab15ab 100644
--- a/source/_integrations/slack.markdown
+++ b/source/_integrations/slack.markdown
@@ -69,12 +69,21 @@ icon:
   type: string
 {% endconfiguration %}
 
+<div class='note'>
+
+Note that in order to modify your Slack bot's username and icon, you must ensure your Slack app has the `chat:write.customize` OAuth scope. See [the Slack API documentation](https://api.slack.com/methods/chat.postMessage#authorship) for more information.
+
+</div>
+
 ### Slack Service Data
 
 The following attributes can be placed inside the `data` key of the service call for extended functionality:
 
 | Attribute              | Optional | Description |
 | ---------------------- | -------- | ----------- |
+| `username`               |      yes | The username of the Slack bot.
+| `icon`                   |      yes | The icon of the Slack bot.
+| `file`                   |      yes | A file to include with the message; see below.
 | `file`                   |      yes | A file to include with the message; see below.
 | `blocks`                 |      yes | Array of [Slack blocks](https://api.slack.com/messaging/composing/layouts). *NOTE*: if using `blocks`, they are shown **in place of** the `message` (note that the `message` is required nonetheless).
 | `blocks_template`        |      yes | The same as `blocks`, but able to support [templates](https://www.home-assistant.io/docs/configuration/templating).