nicolasansom/home-assistant-webhook-converter repository overview

⁠Home Assistant Webhook Converter

Convert GET requests to POST for Home Assistant webhooks - A lightweight Node.js server that enables NFC tags, browsers, and GET-only services to trigger Home Assistant automations. Perfect for Synology NAS Docker deployments.

⁠🎯 What It Does

Home Assistant webhooks only accept POST requests, but NFC tags, browsers, and many services send GET requests. This converter sits between them, automatically converting GET → POST so your NFC tags and browser bookmarks can trigger Home Assistant automations.

Browser/NFC Tag → GET → Webhook Converter → POST → Home Assistant ✅

⁠✨ Features

• 🔗 Link Generator Form - Easy-to-use web interface to generate GET-friendly URLs
• 🔄 Converts GET requests to POST for Home Assistant webhooks
• 📱 Works with NFC tags, browsers, and GET-only services
• 🐳 Docker-ready for Synology Container Manager
• ⚡ Lightweight Node.js server (node:24-alpine)
• 🎯 Simple setup, no configuration needed

⁠🚀 Quick Start

⁠🐳 Synology Container Manager

Perfect for Synology NAS! Search for nicolasansom/home-assistant-webhook-converter in Container Manager's Registry tab.

📖 Need help with setup? Check out the complete step-by-step guide with screenshots on GitHub⁠ for a visual walkthrough of the entire Synology Container Manager setup process.

⁠📖 How to Use

⁠1. Create a Home Assistant Webhook

1. Open Home Assistant → Settings → Automations & Scenes
2. Create a new automation with a Webhook trigger
3. Copy the webhook URL (e.g., http://YOUR_HA_IP:8123/api/webhook/WEBHOOK_ID)

⁠2. Access the Link Generator

Open your browser and navigate to:

http://YOUR_SERVER_IP:3001/

1. Paste your Home Assistant webhook URL in the form
2. Click Generate Link
3. Copy the generated URL

⁠3. Use with NFC Tags or Browser Bookmarks

Use this converter URL in:

• NFC tags - Write the URL to an NFC tag, scan with any phone
• Browser bookmarks - Create a bookmark for quick access
• IFTTT/Shortcuts - Services that only support GET requests

⁠🔍 Health Check

Check if the service is running:

curl http://localhost:3001/health

Response:

{
  "status": "ok",
  "timestamp": "2026-01-04T21:21:27.173Z",
  "nodeVersion": "v24.12.0"
}

⁠📦 Image Details

• Base Image: node:24-alpine
• Port: 3000 (map to any host port)
• Health Check: Built-in (every 30s)
• Logs: Mount /usr/src/app/logs for persistent logs

⁠📝 Environment Variables

• PORT=3000 - Server port (default: 3000)
• NODE_ENV=production - Node environment

⁠🔗 Links

• GitHub: https://github.com/NicolaSansom/home-assistant-webhook-converter⁠
• Issues: https://github.com/NicolaSansom/home-assistant-webhook-converter/issues⁠

⁠📄 License

MIT

Made for Home Assistant users who want to use NFC tags and GET-only services with webhooks.