smoobu-hmac

n8n community node for the Smoobu property management API with HMAC authentication

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 1.0.0
Author: DNAngelX

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

  1. In self-hosted n8n, open Settings → Community Nodes → Install and enter n8n-nodes-smoobu-hmac.
  2. In Smoobu, go to Settings → Advanced → API Keys. Create a key, generate its secret and copy both values.
  3. 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.
  4. 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.

Discussion