Skip to content
Pricing Download Open app
DocsDevelopersHome Assistant Integration

Developers

Home Assistant Integration Both

Integrate TapTidy with Home Assistant to bridge smart home automations with your personal and household task workflows.

Method 1: CalDAV To-Do Entities (Recommended)

Connect TapTidy tasks into Home Assistant using the standard CalDAV integration:

  1. In TapTidy Web, navigate to Settings → Developer → App Passwords and generate a scoped credential with tasks:read and tasks:write.
  2. In Home Assistant, go to Settings → Devices & Services → Add Integration → CalDAV.
  3. Enter your server details:
    • URL: https://your-taptidy-domain/caldav
    • Username: Your TapTidy email address
    • Password: Your generated App Password
  4. Home Assistant discovers your tasks calendar and generates a native todo entity (e.g. todo.taptidy_tasks) for use in Lovelace dashboards and automation triggers.

Method 2: Webhook Automation Triggers

Trigger smart home automations when tasks change or complete:

  1. Create a Webhook trigger automation in Home Assistant (e.g. /api/webhook/taptidy_event).
  2. Register your webhook endpoint URL in TapTidy using POST /api/v1/integrations/zapier/subscriptions selecting events such as task.completed and task.created.
  3. Verify payloads using the X-TapTidy-Signature (HMAC-SHA256) header and trigger automations like announcing finished tasks or adjusting smart lighting.

Method 3: REST API & Personal Access Tokens

Use Home Assistant REST commands or Node-RED nodes authenticated with a TapTidy Personal Access Token (PAT) carrying the tasks:write and tasks:read scopes to programmatically create tasks from smart home events (e.g. creating a chore when the washing machine cycle finishes).

Pro Feature: CalDAV server integration, Webhooks, and Personal Access Tokens are included with TapTidy Pro.