diff --git a/source/_integrations/ifttt.markdown b/source/_integrations/ifttt.markdown
index dd93693c497..f09114a7786 100644
--- a/source/_integrations/ifttt.markdown
+++ b/source/_integrations/ifttt.markdown
@@ -62,11 +62,7 @@ ifttt:
```
`key` is your API key which can be obtained by viewing the **Settings** of the [Webhooks applet](https://ifttt.com/services/maker_webhooks/settings). It's the last part of the URL (e.g., https://maker.ifttt.com/use/MYAPIKEY) you will find under **My Applets** > **Webhooks** > **Settings**.
-
-
-
-Property screen of the Maker Channel
-
+
Once you have added your key to your `configuration.yaml` file, restart your Home Assistant instance. This will load up the IFTTT integration and make a service available to trigger events in IFTTT.
@@ -88,18 +84,29 @@ ifttt:
### Testing your trigger
-You can use **Developer Tools** to test your [Webhooks](https://ifttt.com/maker_webhooks) trigger. To do this, open the Home Assistant sidebar, click on Developer Tools, and then the **Services** tab. Fill in the following values:
+You can use **Developer Tools** to test your [Webhooks](https://ifttt.com/maker_webhooks) trigger. To do this, open the Home Assistant sidebar, click on **Developer Tools** -> **Services** tab. Select `IFTTT: Trigger` as the service and fill in the following values:
-Field | Value
------ | -----
-domain | `ifttt`
-service | `trigger`
-Service Data | `{"event": "EventName", "value1": "Hello World"}`
+{% configuration_basic %}
+event:
+ description: The name of the event to send.
+ required: true
+ type: string
+value1:
+ description: Generic field to send data via the event.
+ required: false
+ type: string
+value2:
+ description: Generic field to send data via the event.
+ required: false
+ type: string
+value3:
+ description: Generic field to send data via the event.
+ required: false
+ type: string
+{% endconfiguration_basic %}
-
-
When your screen looks like this, click the 'call service' button.
-
+
By default, the trigger is sent to all the API keys from `configuration.yaml`. If you
want to send the trigger to a specific key use the `target` field:
@@ -112,19 +119,22 @@ Service Data | `{"event": "EventName", "value1": "Hello World", "target": "YOUR_
The `target` field can contain a single key name or a list of key names.
-### Setting up a recipe
+### Setting up an applet
-Press the *New applet* button and search for *Webhooks*.
+Press the *Create* button and *Add* on **If This**. Search for *Webhooks*.
+
-
-
-Choose "Webhooks" as service.
-
+Choose *Webhooks* service.
+
+
+Select *Receive a web request*.
+
-
-
You need to setup a unique trigger for each event you sent to IFTTT.
-
+
+
+Add the *Then That* action. The below example sends a notification to the IFTTT mobile app and adds `value1` to the message:
+
{% raw %}
diff --git a/source/images/integrations/ifttt/choose_webhook_trigger.png b/source/images/integrations/ifttt/choose_webhook_trigger.png
new file mode 100644
index 00000000000..5c75d4e1c86
Binary files /dev/null and b/source/images/integrations/ifttt/choose_webhook_trigger.png differ
diff --git a/source/images/integrations/ifttt/create_applet.png b/source/images/integrations/ifttt/create_applet.png
new file mode 100644
index 00000000000..af220544a06
Binary files /dev/null and b/source/images/integrations/ifttt/create_applet.png differ
diff --git a/source/images/integrations/ifttt/setup_then_that.png b/source/images/integrations/ifttt/setup_then_that.png
new file mode 100644
index 00000000000..132e7e31f4b
Binary files /dev/null and b/source/images/integrations/ifttt/setup_then_that.png differ
diff --git a/source/images/integrations/ifttt/setup_trigger.png b/source/images/integrations/ifttt/setup_trigger.png
index 12b4e42fe03..21c2e673a78 100644
Binary files a/source/images/integrations/ifttt/setup_trigger.png and b/source/images/integrations/ifttt/setup_trigger.png differ
diff --git a/source/images/integrations/ifttt/testing_service.png b/source/images/integrations/ifttt/testing_service.png
index fb8aa883859..5c49c29b35c 100644
Binary files a/source/images/integrations/ifttt/testing_service.png and b/source/images/integrations/ifttt/testing_service.png differ