diff --git a/source/_components/sensor.waqi.markdown b/source/_components/sensor.waqi.markdown
index 0f78155c79e..9e2118ba4c9 100644
--- a/source/_components/sensor.waqi.markdown
+++ b/source/_components/sensor.waqi.markdown
@@ -21,6 +21,7 @@ To enable this sensor, add the following lines to your `configuration.yaml` file
 # Example configuration.yaml entry
 sensor:
   - platform: waqi
+  	token: AQICN_API_TOKEN
     locations:
       - beijing
     stations:
@@ -31,6 +32,8 @@ Configuration variables:
 
 - **locations** (*Required*): a list of location names to look for air quality data. In case a specific location has multiple registered stations all of them will be added to Home Assistant
 
+- **token** (*Required*): a token for the AQICN public API. Please obtain one at (AQICN API token)[http://aqicn.org/data-platform/token/#/]
+
 - **stations** (*Optional*): a list of station names to look for air quality data. Station should be within locations specified above.
 
 The value reported is an overall AQ index for the location. The values of the index can be interpreted as following: