Set up Getwello with Apple HomeKit

HomeKit doesn't accept webhooks directly. The standard approach is to expose Getwello as a virtual HomeKit accessory via Homebridge, then use Home app automations.

What you need

• A Raspberry Pi, Mac, NAS or always-on device for Homebridge.
• An iCloud account, HomeKit setup ready.
• A Getwello Coordinator account with active subscription.
• About 30 minutes for the first-time Homebridge install.

Step 1: Install Homebridge

Easiest: download the Homebridge installer for your OS from homebridge.io. Set up the admin UI at http://homebridge.local:8581.

Step 2: Install a webhook-listener plugin

In the Homebridge admin UI, Plugins → Search “homebridge-http-webhooks” → Install.

Step 3: Configure a virtual accessory

Add an accessory configuration:

{
  "platform": "HttpWebHooks",
  "webhook_port": 51828,
  "sensors": [{
    "id": "getwello-checkin",
    "name": "Mum's check-in",
    "type": "occupancy"
  }]
}

Save, restart Homebridge.

Step 4: Pair with Home app

Open the Home app on your iPhone, scan the Homebridge pairing QR code. The “Mum's check-in” accessory appears.

Step 5: Create the Getwello webhook subscription

Settings → Developer API → Webhooks. URL: http://your-homebridge:51828/?accessoryId=getwello-checkin&state=true. Tick check_in.created.

Most plugins also expect a close call after a few seconds. Add a small relay or use the plugin's auto-reset option if available.

Step 6: Build a HomeKit automation

In the Home app: Automation → + → A Sensor Detects Something. Pick the Getwello accessory. Then pick an action: announce on HomePod, run a scene, turn on lights.

Troubleshooting

Accessory never triggers: the URL must reach Homebridge. Use a Cloudflare Tunnel or expose port 51828 to the internet, behind a long random path.

Sensor stays “detected”: add a close call to reset, or use the plugin's auto-close option.