diff --git a/source/_components/homematicip.markdown b/source/_components/homematicip.markdown
new file mode 100644
index 00000000000..c6e374ee099
--- /dev/null
+++ b/source/_components/homematicip.markdown
@@ -0,0 +1,43 @@
+---
+layout: page
+title: "HomematicIP"
+description: "Instructions for integrating HomematicIP into Home Assistant."
+date: 2018-03-06 20:40
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: homematicip.png
+ha_category: Hub
+ha_iot_class: "Cloud Polling"
+ha_release: 0.66
+featured: false
+---
+
+The [HomematicIP](http://www.homematicip.com/) component platform is used as an interface to the cloud server. 
+For for communication [homematicip-rest-api](https://github.com/coreGreenberet/homematicip-rest-api) is used.
+
+To set up the component:
+
+- **generate the authentication token**:
+```yaml
+generate_auth_token.py
+```
+
+- ** add the information to your `configuration.yaml` file:
+
+```yaml
+homematicip:
+  - name: NAME
+    accesspoint: IDENTIFIER
+    authtoken: AUTHTOKEN
+```
+
+Configuration variables (global):
+
+- **name** (*Required*): Name to identify your access point, this will be
+  used to prefix your device names.
+- **accesspoint** (*Required*): This is the access point id (SGTIN)
+- **authtoken** (*Required*): Authentification token generated with
+`generate_auth_token.py`.
+