diff --git a/source/_components/mailgun.markdown b/source/_components/mailgun.markdown
index 2f13d2c0625..e1ecaefc72a 100644
--- a/source/_components/mailgun.markdown
+++ b/source/_components/mailgun.markdown
@@ -12,7 +12,7 @@ ha_category: Notifications
 ha_release: 0.38
 ---
 
-The component supports push messages and generates events based on inbound data. To use, add a Route set to Store and Notify with a URL of the following form: `https://<home-assistant-domain>/api/mailgun?api_password=<password>`
+The component supports push messages and generates events based on inbound data. To generate inbound events, add a Route set to Store and Notify with a URL of the following form: `https://<home-assistant-domain>/api/mailgun?api_password=<password>`
 
 To send messages, use the [Mailgun notify platform][notify].
 
@@ -24,11 +24,11 @@ To send messages, use the [Mailgun notify platform][notify].
 # Example configuration.yaml entry
 mailgun:
   domain: mg.example.com
-  api_key: token-XXXXXXXXX
+  api_key: XXXXXXXXXXXXX
 ```
 
 Configuration variables:
 
 - **domain** (*Required*): This is the domain name to be used when sending out mail. Defaults to the first custom domain you have set up.
 - **api_key** (*Required*): This is the API token that has been generated in your Mailgun account.
-- **sandbox** (*Optional*): Whether to use the sandboxed domain for outgoing mail. The `domain` item takes precedence over this. Defaults to `False`.
+- **sandbox** (*Deprecated*): Whether to use the sandboxed domain for outgoing mail. Since the `domain` item is required, it should be set to the sandbox domain name, so this isn't needed.  Defaults to `False`.