diff --git a/source/components/index.markdown b/source/components/index.markdown index d7deeb4bda9..d084bdcef94 100644 --- a/source/components/index.markdown +++ b/source/components/index.markdown @@ -168,6 +168,12 @@ the manufacturers of these devices. Allow sending messages using Notify My Android (NMA) + + +Instapush +Allow sending messages using Instapush + + PushBullet diff --git a/source/components/notify.instapush.markdown b/source/components/notify.instapush.markdown new file mode 100644 index 00000000000..3f319f84201 --- /dev/null +++ b/source/components/notify.instapush.markdown @@ -0,0 +1,42 @@ +--- +layout: page +title: "Instapush otification support" +description: "Instructions how to add Instapush notifications to Home Assistant." +date: 2015-05-01 18:00 +sidebar: false +comments: false +sharing: true +footer: true +--- + + +The instapush platform uses [Instapush](https://instapush.im) to delivery notifications from Home Assistant to your Android or iOS device. + +The Instapush [Getting Started page](https://instapush.im/home/start/) will guide through the process of creating the required items. + +```yaml +# Example configuration.yaml entry +notify: + platform: instapush + # Get those by creating a new application, event, and tracker on https://instapush.im + api_key: ABCDEFGHJKLMNOPQRSTUVXYZ + app_secret: ABCDEFGHJKLMNOPQRSTUVXYZ + event: ABCDEFGHJKLMNOPQRSTUVXYZ + tracker: ABCDEFGHJKLMNOPQRSTUVXYZ +``` + +To retrieve those values for existing settings, log into your account at https://instapush.im and go to your **Dashboard**. Then click **APPS** tab, choose an app, and check the **Basic Info** section. The *Application ID* is the ``api_key`` and ``app_secret`` is the *Application Secret*. + +It's easy to test your Instapush setup outside of Home Assistant. Assuming you have an event *notification* and a tracker *home-assistant*, just fire a request and check the Instapush dashboard for a new entry. + +```bash +curl -X POST \ + -H "x-instapush-appid: YOUR_APP_KEY" \ + -H "x-instapush-appsecret: YOUR_APP_SECRET" \ + -H "Content-Type: application/json" \ + -d '{"event":"notification","trackers":{"home-assistant":"Switch 1"}}' \ + https://api.instapush.im/v1/post +``` +For further details, please check the [API](https://instapush.im/developer/rest). + +To use notifications, please see the [getting started with automation page]({{site_root}}/components/automation.html). diff --git a/source/images/supported_brands/instapush.png b/source/images/supported_brands/instapush.png new file mode 100644 index 00000000000..5d2d8fb72c7 Binary files /dev/null and b/source/images/supported_brands/instapush.png differ