Homebridge Syntex Webhooks

2.3.8 verified Sat May 09 auth: no javascript

A Homebridge plugin (v2.3.8) that enables HTTP webhook control for HomeKit accessories. It allows defining custom webhook endpoints to trigger actions on accessories, supports automation with timepoints, weekdays, delays, and logical operations, and provides a built-in web server for management. This plugin is actively maintained by SynTexDZN and integrates with Homebridge >=0.3.0 on Node >=9.11.2. Key differentiators: ability to handle multiple webhooks, automation engine, and a web-based device management interface. Releases are periodic with bug fixes and feature additions.

Common errors

error The plugin 'SyntexWebhooks' does not exist or is not installed. ↓

cause Missing package installation or incorrect platform name.

fix

Run 'npm install -g homebridge-syntex-webhooks' and ensure platform name is exactly 'SyntexWebhooks'.

error Port 51828 is already in use. ↓

cause Another service is using the same port.

fix

Change the 'port' setting to an unused port (e.g., 51829).

error Authentication failed: invalid username or password. ↓

cause Incorrect credentials in config or default credentials unchanged.

fix

Update 'auth' section with correct username/password.

error Failed to fetch webhook: HTTP request error. ↓

cause Webhook URL is unreachable or returns error.

fix

Verify the webhook URL is correct and the target device is reachable.

Warnings

breaking Automation system restructured: require updating automation.json before upgrading to 2.3.x. ↓

fix Review automation documentation and adjust automation.json according to new structure.

gotcha Default authentication is 'admin/admin'. Change immediately to avoid unauthorized access. ↓

fix Set custom username/password in config.

deprecated Older versions used a different webhook format that may not be compatible with 2.x. ↓

fix Update to latest version and follow migration guide.

breaking Node.js >=9.11.2 required. Older versions will fail. ↓

fix Upgrade Node.js to version 9.11.2 or higher.

Install

npm install homebridge-syntex-webhooks

yarn add homebridge-syntex-webhooks

pnpm add homebridge-syntex-webhooks

Imports

SyntexWebhooks
wrong
```
const SyntexWebhooks = require('homebridge-syntex-webhooks');
```
correct
```
import SyntexWebhooks from 'homebridge-syntex-webhooks';
```
This package does not export a default; it is a Homebridge plugin, so it should be installed and configured via Homebridge config, not imported directly.

Quickstart

Shows basic configuration of a SyntexWebhooks platform with one switch device controlled by two webhook URLs.

// Configure in Homebridge config.json:
{
  "platforms": [
    {
      "platform": "SyntexWebhooks",
      "name": "SyntexWebhooks",
      "port": 51828,
      "auth": {
        "username": "admin",
        "password": "admin"
      },
      "devices": [
        {
          "name": "Living Room Lamp",
          "type": "switch",
          "webhooks": [
            {
              "on": "http://192.168.1.100/on",
              "off": "http://192.168.1.100/off"
            }
          ]
        }
      ]
    }
  ]
}