Webhooks let you activate Homey Flows from external sources, such as other smart home devices, scripts, or automation tools like Postman.
A Webhook is a simple HTTP request sent to Homey that can activate a Flow. Homey offers a cloud-based Webhook service, with local Webhook options available for Homey Pro users.
Webhooks are a powerful way to integrate Homey with other services and devices. Whether using the cloud or local network, they enable automation beyond Homey’s built-in capabilities.
Webhook URL Formats
The default Webhook format for Homey is:
https://webhook.homey.app/<homey-id>/<event>
- <homey-id>: Your unique Homey ID.
- <event>: The event name that activates the Flow.
If you prefer to send Webhooks locally (without using the cloud), use one of these formats:
Homey Pro (Early 2023) & Homey Pro mini
http://ip-of-homey/webhook?event=my_event&tag=my_tag
Homey Pro (2016 — 2019)
http://ip-of-homey/api/manager/logic/webhook/<my_event>?tag=my_tag
Example: sending Webhooks via Postman to a Flow with a Tag
Postman helps test Webhooks before integrating them into other systems. The following steps outline how to create a Flow with a Webhook trigger, which can be initiated in Postman.
1. Create a Flow with a Webhook
Open the Homey app and go to Flows
→ →
New Flow
.
In the When section, tap Logic
→ Webhook event Event has been received
.
Set the Event name (for instance, ‘example_event’).
In the Then section, add the desired actions. Optionally, you can add a Tag, like in the push notification example below.
Finally, save your Flow.
2. Sending a Cloud Webhook
Open Postman, select GET as the request type, and enter the Webhook URL:
https://webhook.homey.app/<homey-id>/my_event
If you want to send additional information, you can use a Tag. For example:
https://webhook.homey.app/<homey-id>/example_event&tag=hello
Now, click Send
to activate the Flow. Postman returns a 200 OK response if all goes well.
In this example, a Flow starts that sends a push notification containing the Tag value.