Package Information
Available Nodes
Documentation generating…
Documentation
Smoobu for n8n
Use the Smoobu property management API in n8n with an API key and HMAC secret. The node signs every request with HMAC-SHA256 using a UTC timestamp, a fresh UUID and the exact request body. Smoobu HMAC documentation
Install and connect
- In self-hosted n8n, open Settings → Community Nodes → Install and enter
n8n-nodes-smoobu-hmac. - In Smoobu, go to Settings → Advanced → API Keys. Create a key, generate its secret and copy both values.
- Add a Smoobu node in n8n and create a Smoobu HMAC API credential. Enter the API key and secret. The credential check calls
GET /api/me. - To verify the connection in a workflow, select User → Get Current User and execute the node.
For a manual installation from a local checkout, build the tarball with npm ci && npm pack, install the resulting absolute .tgz path with npm install /path/to/n8n-nodes-smoobu-hmac-1.0.0.tgz from the n8n user folder's nodes directory and restart n8n. Registry installation requires public npm availability. Installation on n8n Cloud is subject to n8n's community-node verification. Manual installation · n8n verification
Operations
| Resource | Operations |
|---|---|
| Add-on | List, optionally by apartment |
| Apartment | Get, list |
| Availability | Check availability and price |
| Guest | Get, search/list |
| Message | List reservation messages, list threads, send to guest, send to host |
| Online Check-In | Get, create. Requires Smoobu partner access |
| Placeholder | Get, list, create, update, delete, get values for a reservation |
| Placeholder Translation | Get, list, create, update, delete |
| Price Element | Get, list, create, update, delete |
| Rate | Get, update |
| Reservation | Get, list, create, update, cancel |
| User | Get current user |
| Webhook | Get, list, create, update, delete webhook registrations |
| Custom API Request | Make a signed request to a relative Smoobu API path |
Webhook events can be received with n8n's built-in Webhook trigger using its production URL as the registration callback.
Fields that accept JSON support n8n expressions. Use Smoobu's API field names in Query Parameters and JSON Body. For example, Reservation → Get Many accepts {"from":"2027-04-01","to":"2027-04-30","apartmentId":123,"pageSize":100}. An array such as {"apartments":[123,456]} sends repeated apartments[] parameters. Smoobu API reference
List operations with Split Into Items enabled emit one n8n item per returned record. Return All fetches every page starting at page 1 for reservations, guests, reservation messages and threads. Disable splitting to keep the API response and page metadata together. When fetching one page, use the documented page parameters in Query Parameters. Responses without a body return the HTTP status code.
For Custom API Request, enter a path such as /api/reservations/123. Calls are sent to https://login.smoobu.com with redirects disabled. Check the API key, HMAC secret and n8n host clock if Smoobu returns HTTP 401.
Development and releases
Use Node.js 22.14+ for local development. CI and release builds use Node.js 24.
npm ci
npm run lint
npm test
npm pack --dry-run
For a new npm package, authenticate with npm login and run npm publish --access public from the verified checkout. Complete npm's browser verification if prompted. The package will appear at npmjs.com/package/n8n-nodes-smoobu-hmac.
For subsequent releases, push the source to a public GitHub repository matching the repository.url in package.json. In npm package settings, configure a GitHub Actions trusted publisher for that repository and publish.yml and allow direct publishing. Push a tag matching the package version, such as v1.0.1 for 1.0.1. GitHub Actions builds and tests the tagged source and publishes its tarball with provenance. npm Trusted Publishing
MIT licensed. Community-maintained integration.