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.
Finding your Homey ID
You can find your Homey ID by navigating to More (…) → Settings → General in the Homey app.
If you prefer to send Webhooks locally (without using the cloud), use one of these formats:
Homey Pro (2023 — 2026) & 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_tagUse your Homey’s local IP address
Replace ‘ip-of-homey’ with your Homey’s local IP address. Also, sending Webhooks locally only works when your device is on the same local network as Homey.
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 Flow → → 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_eventIf you want to send additional information, you can use a Tag. For example:
https://webhook.homey.app/<homey-id>/example_event&tag=helloNow, 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.
