spotclean

n8n community node for SpotClean — clients, houses, visits, invoices, and webhook events

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.6
Author: LHC Tech

Available Nodes

Documentation generating…

SpotClean icon
SpotClean
Manage SpotClean clients, houses, visits, and invoices
SpotClean Trigger icon
SpotClean Trigger
Starts the workflow when SpotClean emits a selected event

Documentation

SpotClean for n8n

n8n community node for SpotClean — automate clients, properties (houses), visits, and invoices, and react instantly when something changes in SpotClean.

Works on n8n Cloud after the package is published as a verified community node, and on self-hosted n8n via npm.

n8n is a fair-code licensed workflow automation platform.

Installation

n8n Cloud (verified)

  1. Open the Nodes panel → search SpotClean.
  2. Install from More from the community (workspace owner).
  3. Add SpotClean API credentials with your sc_live_… key.

Self-hosted

Follow the community nodes installation guide, package name: n8n-nodes-spotclean.

Credentials

  1. Sign in to SpotClean (admin panel).
  2. Go to Settings → Integrations.
  3. Open n8n, create an API key (sc_live_…), and paste it into the n8n credential.
  4. Optional: set Base URL (default https://api.spotclean.app) for staging.

You need an active SpotClean plan that includes Integrations.

Nodes

SpotClean Trigger

Starts the workflow when SpotClean publishes an event. Pick one event per trigger:

Event When it fires
client.created / client.updated Client is created or updated
house.created Property is created
visit.created / visit.changed / visit.canceled / visit.finished Visit lifecycle
invoice.created / invoice.paid Invoice created or marked paid

Uses SpotClean REST Hooks (POST/DELETE /api/integrations/v1/hooks).

SpotClean (actions)

Resource Operations
Client Get Many, Get, Create, Update, Delete
House Get Many, Get, Create, Update, Delete
Visit Get Many, Get, Create, Update, Cancel
Invoice Get Many, Get, Create, Mark Paid, Delete

Dropdowns cascade (Client → House → Visit / Invoice) so you do not need to copy IDs by hand.

Typical workflows

  • When a visit is finished, create a row in Google Sheets or notify Slack.
  • When a client is created, sync them to your CRM.
  • On a schedule, Get Many visits for the day and send a digest email.
  • When an invoice is paid, update accounting.

API docs

Development

npm install
npm run build
npm run lint
npm run dev   # local n8n with this package hot-reloaded

Verified community node constraints: no runtime dependencies (only n8n-workflow peer). Publish via GitHub Actions with provenance — see PUBLISH.md.

License

MIT

Discussion