tanss

n8n community node to use the TANSS API

Package Information

Released: 2 mo ago
Downloads: 25 weekly / 472 monthly
Latest Version: 1.2.1

Available Nodes

TANSS icon
TANSS
Interact with the TANSS API

Documentation

n8n-nodes-tanss

[!WARNING]
Before upgrading, check BREAKING_CHANGES.md for migration details.

License: MIT
CodeFactor


This is an n8n community node. It lets you use the TANSS API in your n8n workflows.
TANSS is a professional ticket and service management system for handling support tickets, customer communication, and internal processes.

n8n is a fair-code licensed workflow automation platform.

Contents

Installation

For installation in n8n

Follow the official installation guide in the n8n community nodes documentation.

For Local Development

This project is an n8n community node and must be run from source for local development.

Prerequisites

  • Node.js (v22.20.0 recommended)
  • npm

1. Clone the repository

You can clone the repository anywhere on your system — it does not need to be inside the n8n directory.

git clone https://github.com/BuddiesD/n8n-nodes-tanss.git
cd n8n-nodes-tanss

2. Install dependencies

npm install

3. Start development mode

Run the node in development mode with live reloading:

npm run dev

This command uses n8n-node dev to build the node, start a local n8n instance, and automatically apply code changes during development.

npm run dev is equivalent to running n8n-node dev directly.

Development (Dev Container)

To start n8n with the custom node, run: npm run dev

Note: The first startup may time out because n8n is being downloaded and set up.

Operations

208 operations across 30 resources. Each resource's operations and their parameters are documented in the docs/ directory.

Resource Operations Docs
Activity Feed 4 docs/activityFeed.md
Availability 2 docs/Availability.md
Call 9 docs/calls.md
Call User 3 docs/callsuser.md
Callback 5 docs/Callback.md
Chat 10 docs/chats.md
Checklist 12 docs/Checklists.md
Company 4 docs/Company.md
Company Category 10 docs/CompanyCategories.md
Component 9 docs/Components.md
CPU 5 docs/CPUs.md
Domain 6 docs/Domains.md
Employee 2 docs/Employees.md
HDD Type 5 docs/hddTypes.md
IP 4 docs/ips.md
Mail 7 docs/Mails.md
Manufacturer 5 docs/manufacturers.md
Operating System 5 docs/OperatingSystems.md
PC 5 docs/PCs.md
Periphery 11 docs/Periphery.md
Project 9 docs/Projects.md
Remote Support 11 docs/RemoteSupports.md
Search 1 docs/Search.md
Service 5 docs/services.md
Software License 16 docs/SoftwareLicenses.md
Ticket 10 docs/Tickets.md
Ticket Content 5 docs/TicketContent.md
Ticket List 9 docs/TicketLists.md
Ticket State 4 docs/TicketStates.md
Timestamp 3 docs/timestamp.md

For implementation status (done / testing / planned), see the ToDo list. For the full TANSS API reference, visit api-doc.tanss.de.

Credentials

Authentication is now fully credential-based and also works with n8n HTTP Request using TANSS credentials.

Use the node parameter Auth Mode and select one credential type:

  • User Login (Auto Refresh)

    • Credential: TANSS User API
    • Fields: Base URL, Username, Password, optional 2FA Secret
    • Automatically refreshes tokens using refreshToken when possible

  • Generated Token

    • Credential: TANSS Generated Token API
    • Fields: Base URL, Generated API Token
    • Uses static generated token scopes (no refresh)

Compatibility

Compatible with n8n@1.60.0 or later

Tested with TANSS API. Version: 10.15.0

Resources

To-Do / Progress

A detailed breakdown of all implemented and pending API endpoints is available in the ToDo list.

Quick stats:

Metric Value
Implemented 208
ToDo 363
Planned (Implemented + ToDo) 571
Not Planned 286
Completion 36%
Total API Endpoints 857

Disclaimer

This is an unofficial, community-maintained project it is not affiliated with, endorsed by, or sponsored by TANSS or its parent company.

  • Trademarks: "TANSS" and all related names, logos, and product identifiers are trademarks of their respective owners. Their use here is purely descriptive and does not imply any official relationship.
  • Access requirement: Using this node requires a valid TANSS installation with appropriate API permissions. The authors are not responsible for providing or facilitating access to any TANSS system.
  • No warranty: This software is provided as-is, without any express or implied warranties. The authors make no guarantees regarding:
    • Correctness or completeness of the API integration
    • Compatibility with specific TANSS versions
  • Liability: In no event shall the authors be held liable for any damages arising from the use of this software, including but not limited to data loss, service interruptions, or business disruptions.

Contributing

Thank you for considering contributing to this project! Community contributions are what keep open-source projects growing and improving, and every contribution is highly appreciated.

When submitting bug reports, please make sure they are:

  • Reproducible – clearly describe the steps required to reproduce the issue.
  • Detailed – include relevant information such as versions, environment, and setup.
  • Unique – avoid creating duplicate issues by checking existing ones first.
  • Focused – report one bug per issue to keep discussions clear and effective.

Discussion