Webhooks allow you to send data to your Home Assistant instance via Home Assistant Cloud. You can use these webhooks for example to trigger automations.

Triggering an automation with a webhook trigger

This tutorial will show you the following:

1. How to manually create a webhook.
2. How to use this webhook in an automation.
3. We will be able to trigger this automation from anywhere in the world and use the data in the trigger.

Prerequisites

• Home Assistant installed and up and running
• Have administrator rights on Home Assistant
• Have a Home Assistant Cloud subscription
• Have Home Assistant Cloud enabled in Home Assistant

To create a webhook trigger and use it in an automation

1. To start creating a new automation, go to Settings > Automations & scenes.

   • In the bottom right corner, select Create automation, then, select Create new automation.

2. Under Trigger, select Webhook.

   • Under Webhook ID, leave the ID as is.
   • Select the cogwheel, and make sure the Only accessible from the local network is cleared (de-selected).
     • This means your webhook is now accessible via cloud.

3. Under Action, in the Search action field, type "li" and select Light Turn On from the list.

   • In the bottom right corner, select Save.
   • Your automation is now created.

4. Go to Settings > Cloud and scroll to the webhooks card.

   • You will now see your newly created webhook.

5. Next to the webhook, select Manage.

   • A dialog opens, showing you a unique URL. You can use to this URL to trigger your automation.
   • If you're on a Linux or Mac, you can test it out with the following commands:

   curl -X POST <the webhook url>
   

   • Form data or JSON data sent to the webhook endpoint will be available to templates in your automation as trigger.data or trigger.json.
   

Related topics

• Webhook integration documentation
• Nabu Casa account pricing
• Nabu Casa account log in page
• Enabling Home Assistant Cloud in Home Assistant