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:
- In TapTidy Web, navigate to Settings → Developer → App Passwords and generate a scoped credential with
tasks:readandtasks:write. - In Home Assistant, go to Settings → Devices & Services → Add Integration → CalDAV.
- Enter your server details:
- URL:
https://your-taptidy-domain/caldav - Username: Your TapTidy email address
- Password: Your generated App Password
- URL:
- Home Assistant discovers your tasks calendar and generates a native
todoentity (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:
- Create a Webhook trigger automation in Home Assistant (e.g.
/api/webhook/taptidy_event). - Register your webhook endpoint URL in TapTidy using
POST /api/v1/integrations/zapier/subscriptionsselecting events such astask.completedandtask.created. - 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.