@seventhingscompany/n8n-nodes-seventhings

This is an n8n community node. It lets you use seventhings in your n8n workflows.

seventhings is an asset-management and inventory platform for tracking physical assets, tasks, rental cases, locations, rooms, persons, users, files and Circularity Hub workflows across an organization. This package adds two nodes: a seventhings action node for reading and writing those records, and a seventhings Trigger node that starts workflows when records change.

n8n is a fair-code licensed workflow automation platform.

Installation Operations Credentials Compatibility Usage Resources Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

Install the package @seventhingscompany/n8n-nodes-seventhings from Settings → Community Nodes in your n8n instance.

Operations

This package provides two nodes.

seventhings (action node)

Manage assets, tasks, rental cases, locations, rooms, files, persons, users, field definitions and Circularity Hub records. The node is organized by resource, each with its own set of operations.

| Resource | Operations | |----------|------------| | Asset | Create, Update, Get, Get Many, Archive, Unarchive, Delete, Move to Location, Move to Room, Attach File, Detach File | | Task | Create, Update, Get, Get Many, Close, Reopen, Delete | | Rental Case | Create, Update, Get, Get Many, Delete | | Location | Create, Update, Get, Get Many, Delete | | Room | Create, Update, Get, Get Many, Delete | | File | Upload, Get, Get Many, Download Data, Download Thumbnail | | Person | Create, Update, Get, Get by ID, Get Many, Delete, Create User | | User | Get, Get by ID, Get Many | | Field Definition | Create, Update, Get, Get Many | | Circularity Hub Item | Add Objects, Suggest Category, Suggest Rest Price, Get, Get Many, Update, Delete | | Circularity Hub Order | Create, Get, Get Many, Update |

Notes:

• Get looks a record up by UUID; Get Many lists/filters records with a Return All toggle and a Limit.
• Asset and Room Create/Update expose your tenant's own custom fields dynamically (via a resource mapper that reads the field definitions), so the inputs match your seventhings configuration.
• Asset → Create supports a find-or-create behaviour to avoid duplicates.
• Asset → Attach File / Detach File target an attachment-type field, picked from a dropdown of the asset's attachment fields.
• Room records belong to a Building (a Location), selected from a dropdown.
• File → Upload accepts either an upstream node's binary data or a public URL to download, and returns the uploaded file's UUID — which you can then attach to an asset.
• File → Download Data / Download Thumbnail write binary output to a configurable binary property.
• Person Create/Update uses your tenant's person field definitions dynamically, matching the SDK's flexible field map.
• Field Definition operations are schema administration operations for Asset, Room and Person templates.
• Circularity Hub operations cover SDK item/order workflows, category and rest-price suggestions, and adding assets to the hub.

seventhings Trigger (polling)

Starts a workflow when seventhings records change. The trigger polls the API (there are no webhooks). Pick one event:

• New Asset, Updated Asset
• New Task, Updated Task, Task Closed, Task Reopened, Task Overdue, Task Due Soon
• New Rental Case, Updated Rental Case, Rental Case Returned

Task Due Soon has a Days Ahead input (default 3) controlling how far ahead to look for upcoming deadlines.

Credentials

You need a seventhings account and API access.

Prerequisites

• A seventhings instance (you log in at https://<yourcompany>.seventhings.com).
• A Client ID, found in seventhings under Integrations → Rest API.

Setting up the credential

Create a Seventhings API credential with:

• Subdomain — the <yourcompany> part of your seventhings URL.
• Username — your seventhings login (an email address).
• Password — your seventhings password.
• Client ID — from Integrations → Rest API.

Authentication uses a session bearer token obtained via a password grant. n8n fetches and caches the token automatically and refreshes it when it expires, so you only ever enter the four fields above. Use Test to confirm the connection.

Compatibility

• Requires n8n 1.x (uses n8nNodesApiVersion: 1).
• Built and tested against Node.js 20+.

No known incompatibilities. If you hit one, please open an issue.

Usage

• Records are selected through searchable dropdowns (resource locators) — start typing to find an asset, task, location, room or rental case, or paste a UUID directly.
• For list operations, enable Return All to fetch every record, or leave it off and set a Limit.
• For Asset → Attach File / Detach File, first Upload a file (File resource) to get its UUID, then choose the asset's attachment field from the dropdown.
• For File → Download Data / Download Thumbnail, set Output Binary Field to the binary property name downstream nodes should read.
• For Field Definition Create/Update and Circularity Hub Update operations, JSON inputs are validated before requests are sent.
• The action node is usable as a tool by AI agents.

New to n8n? See the Try it out documentation to get started.

Resources

• n8n community nodes documentation
• seventhings API documentation

Version history

0.3.0

Expanded SDK parity with Files, Persons, Users, Field Definitions and Circularity Hub:

• File metadata lookup/list and binary data/thumbnail downloads.
• Person create/update/get/list/delete and create-user workflows.
• Read-only user lookup/list operations.
• Field Definition create/update/get/list for Asset, Room and Person templates.
• Circularity Hub item/order operations, suggestions and add-object workflow.

0.1.0

Initial release. Full parity with the seventhings Zapier integration:

• seventhings action node with Asset, Task, Rental Case, Location, Room and File resources.
• seventhings Trigger node with 11 polling events.
• Session-token authentication with automatic refresh.