Important for the old Tanss Node Users

A new TANSS Node was released on October 27, 2025 here.
Please note that existing credentials are not compatible due to the introduction of 2FA (Two-Factor Authentication).

You can install both versions, but 2FA functionality will only be visible after uninstalling the old package.

Old: n8n-nodes-tanss-api New: n8n-nodes-tanss

Breaking Changes (Credentials & Auth)

Important: Updating from older versions to versions greater than 1.1.0 can break existing workflows until credentials and auth setup are migrated.

• The legacy credential TanssApi is removed.
• Authentication is now handled via Auth Mode and two credential types:
  • TANSS User API (username/password, optional 2FA, auto refresh)
  • TANSS Generated Token API (static generated token)
• Existing workflows using old credentials must be reconfigured with one of the new credential types.
• The old dedicated Authentication resource/node operations were removed.
• If your workflow previously used Authentication operations to obtain tokens manually, switch to normal resource operations with the configured credentials.
• TANSS credentials are now also usable in the normal n8n HTTP Request node.

n8n-nodes-tanss

n8n is a fair-code licensed workflow automation platform.

Contents

• Installation
• Operations
• Credentials
• Compatibility
• Resources
• ToDo
• Changelog
• Contributing

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

The following operations are supported by this node and are documented in the ToDo list and the TANSS API documentation.

Operations currently implemented in the node are marked as Done or Testing in the ToDo list. A complete overview of all available operations can be found in the TANSS API documentation.

• ToDo
• Tanss API documentation

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 [email protected] or later Tested with TANSS API. Version: 10.12.0

Resources

• n8n community nodes documentation
• Tanss API documentation

To-Do / Progress

Status / Progress
Progress: 164 / 270 (1 not in API Docs) (61%)

• [x] [POST] Creates a ticket in the database
• [x] [GET] Gets a ticket by id
• [x] [DEL] Deletes a ticket by id
• [x] [PUT] Updates a ticket
• [x] [GET] Gets a ticket history
• [x] [POST] Creates a comment
• [x] [PUT] Merge two Tickets (not in API Docs)

• [x] [GET] gets a list of own tickets (assigned to currently logged in employee)
• [x] [GET] gets a list of general tickets (assigned to no employee)
• [x] [GET] gets a list of company tickets
• [x] [GET] gets a list of tickets of all technicians
• [x] [GET] gets a list of repair tickets
• [x] [GET] gets a list of not identified tickets
• [x] [GET] gets a list of all projects
• [x] [GET] gets a list of all tickets which are assigned to local ticket admins
• [x] [GET] gets a list of all ticket which a technician has a role in
• [x] [PUT] Get a (custom) ticket list

• [x] [GET] Gets all ticket documents
• [x] [GET] Gets a ticket document
• [x] [GET] Gets all ticket images
• [x] [GET] Gets a ticket image
• [x] [POST] upload a document/image

• [x] [GET] Gets a list of all ticket states
• [x] [POST] Creates a ticket state
• [x] [PUT] Updates a ticket state
• [x] [DEL] Deletes a ticket state

• [x] [GET] gets a list of timestamps from a given period
• [x] [POST] writes a timestamp into the database
• [x] [PUT] edits a single timestamp
• [x] [PUT] writes the timstamps of a whole day into the database at once
• [x] [GET] gets the timestamp infos for a given time period
• [x] [GET] gets the timestamp infos for a given time period (with statistical values)
• [x] [POST] does one or more "day closings" for the timestamp module
• [x] [DEL] remove / undo one or more "day closings" for the timestamp module
• [x] [GET] gets all infos about last dayclosings for employees
• [x] [POST] created dayClosings to a given date
• [x] [POST] sets the initial balance for this employee
• [x] [GET] gets a list of all pause configs
• [x] [POST] creates a pause config
• [x] [PUT] updates a pause config
• [x] [DEL] deletes a pause config

• [x] [POST] Creates/imports a phone call into the database
• [x] [PUT] Get a list of phone calls
• [x] [GET] Get phone call by id
• [x] [PUT] Update phone call
• [x] [POST] identifies a phone call
• [x] [GET] Get all employee assignments
• [x] [POST] Creates a new employee assignment
• [x] [DEL] Deletes an employee assignment
• [x] [POST] Creates a call notification

• [x] [PUT] Get a list of phone calls
• [x] [GET] Get phone call by id
• [x] [POST] identifies a phone call

• [x] [POST] Creates/imports a remote support into the database
• [x] [PUT] Get list of remote supports
• [x] [GET] Get remote support by id
• [x] [PUT] Updates a remote support
• [x] [DEL] Delete remote support
• [x] [GET] Gets all device assignments
• [x] [POST] Creates a device assignment
• [x] [DEL] Deletes a device assignment
• [x] [GET] Gets all technician assignments
• [x] [POST] Creates a technician assignment
• [x] [DEL] Delets a technician assignment

• [ ] [POST] Creates a ticket, using the monitoring api
• [ ] [POST] Assigns a groupName to a company or device
• [ ] [DEL] Delete a group assignment
• [ ] [GET] Gets all group assignments
• [ ] [GET] Gets ticket(s), based on a given group
• [ ] [GET] Gets a ticket (created by the monitoring api) by id
• [ ] [PUT] Updates a ticket (created by the monitoring api) by id

• [ ] [POST] Insert new invoices
• [ ] [GET] Gets a list of billable supports
• [ ] [GET] Get a list of customers and employees
• [ ] [POST] Insert new customers
• [ ] [POST] create a new ticket
• [ ] [GET] gets a list of tickets states
• [ ] [GET] gets a list of tickets types
• [ ] [POST] upload a document/image into a ticket
• [ ] [GET] get all employees from the own company
• [ ] [GET] gets all departments
• [ ] [GET] list of company categories
• [ ] [POST] Creates a new company category
• [ ] [GET] gets all employees of a department
• [ ] [GET] search for a company
• [ ] [GET] gets all departments of a employee
• [ ] [GET] gets all users with the associated departments

• [x] [POST] Creates a new chat
• [x] [PUT] Get a list of chats
• [x] [GET] Gets a chat
• [x] [GET] Gets chat close requests
• [x] [POST] Creates a new chat message
• [x] [POST] Adds a participant
• [x] [DEL] Deletes a participant
• [x] [POST] Closes a chat
• [x] [PUT] Accept/decline close request
• [x] [POST] re-opens a chat

• [ ] [POST] Creates a new erp selection
• [ ] [GET] Fetches an erp selection
• [ ] [PUT] Updates an erp selection
• [ ] [DEL] Deletes an erp selection
• [ ] [GET] Gets list of offer templates
• [ ] [POST] Creates an offer template
• [ ] [GET] Gets an offer templates
• [ ] [PUT] Updates an offer templates
• [ ] [DEL] Deletes an offer template
• [ ] [GET] material picker
• [ ] [GET] material picker for erp selection
• [ ] [PUT] Gets list of offers
• [ ] [POST] Creates an offer
• [ ] [GET] Gets an offer
• [ ] [PUT] Updates an offer
• [ ] [DEL] Deletes an offer

• [x] [GET] Fetches availability infos

• [x] [GET] Gets all technicians
• [x] [POST] creates an employee

• [x] [POST] Test email smtp settings

• [ ] [POST] Creates a new tag
• [ ] [GET] Get all tags
• [ ] [GET] Gets a tag
• [ ] [PUT] Edits a tag
• [ ] [DEL] Deletes a tag
• [ ] [POST] Assigns a tag
• [ ] [DEL] Removes a tag
• [ ] [GET] List of tags to an assignment
• [ ] [PUT] Assigns multiple tags
• [ ] [GET] List of tags logs to an assignment

• [x] [POST] Creates a callback
• [x] [PUT] Get a list of callbacks
• [x] [GET] Gets a callback
• [x] [PUT] Updates a callback

• [x] [PUT] global search

• [x] [POST] Assigns a checklist to a ticket
• [x] [DEL] Removes a checklist from a ticket
• [x] [GET] Gets checklists for a ticket
• [x] [GET] Gets checklist for ticket
• [x] [PUT] Check an item

• [ ] [PUT] Get a support list
• [ ] [POST] Creates a support/appointment
• [ ] [GET] Gets a support/appointment
• [ ] [PUT] Edits a support/appointment
• [ ] [POST] Uploads a signature for supports

• [ ] [GET] Get all timers of current user
• [ ] [POST] Creates a timer
• [ ] [DEL] Deletes a timer
• [ ] [GET] Get a specific timer
• [ ] [PUT] Starts/stops timer
• [ ] [GET] Get all timer fragments
• [ ] [DEL] Deletes a timer fragment
• [ ] [PUT] Updates a timer fragment

• [x] [GET] Gets a pc by id
• [x] [PUT] Updates a pc
• [x] [DEL] Deletes a pc
• [x] [POST] Creates a pc
• [x] [PUT] Gets a list of pcs

• [x] [GET] Gets a periphery by id
• [x] [PUT] Updates a periphery
• [x] [DEL] Deletes a periphery
• [x] [POST] Creates a periphery
• [x] [PUT] Gets a list of peripheries
• [x] [GET] Get periphery types
• [x] [POST] Create periphery type
• [x] [PUT] Update periphery type
• [x] [DEL] Delete periphery type
• [x] [POST] Assign periphery
• [x] [DEL] Delete periphery assignment

• [x] [GET] Gets a component by id
• [x] [PUT] Updates a component
• [x] [DEL] Deletes a component
• [x] [POST] Creates a component
• [x] [PUT] Gets a list of components
• [x] [GET] Gets a list of component types
• [x] [POST] Create component type
• [x] [PUT] Update component type
• [x] [DEL] Delete component type

• [ ] [POST] Creates a service
• [ ] [GET] Gets a list of all services
• [ ] [GET] Gets a service by id
• [ ] [PUT] Updates a service
• [ ] [DEL] Deletes a service

• [x] [GET] Gets ip addresses
• [x] [POST] Creates an ip address
• [x] [PUT] Update ip address
• [x] [DEL] Deletes an ip address

• [x] [POST] Creates a new company
• [x] [GET] Gets all employees of a company

• [x] [GET] list of categories
• [x] [POST] Creates a new company category
• [x] [GET] gets a category
• [x] [PUT] updates a category
• [x] [DEL] Deletes a company category
• [x] [GET] list of company types
• [x] [POST] Creates a new company type -- This option is experiencing a error right now. A fix will be included in the next Tanss update.
• [x] [GET] gets a company type
• [x] [PUT] updates a company type
• [x] [DEL] Deletes a company type

• [ ] [PUT] Get a list of company documents
• [ ] [POST] Creates a document
• [ ] [GET] Get a single document (including content)
• [ ] [PUT] Updates a document
• [ ] [DEL] Deletes a document
• [ ] [POST] Uploads a file

• [ ] [POST] creates a rule
• [ ] [PUT] get a list of rules
• [ ] [PUT] updates a rule
• [ ] [GET] gets a rule
• [ ] [DEL] deletes a rule
• [ ] [PUT] test a rule

• [ ] [GET] Gets the ticket board with all panels
• [ ] [GET] Gets an empty ticket board panel
• [ ] [POST] Creates a new ticket board panel
• [ ] [PUT] Updates a ticket board panel
• [ ] [GET] Gets a ticket board panel
• [ ] [DEL] Deletes a ticket board panel
• [ ] [GET] Gets all registers from a ticket board panel
• [ ] [GET] Gets a ticket board from a project
• [ ] [GET] Gets all registers from a ticket board project
• [ ] [GET] Get global ticket panels

• [x] [POST] Creates a new os
• [x] [GET] Get a list of all os
• [x] [PUT] Updates a os
• [x] [GET] Get a specific os
• [x] [DEL] Deletes a specific os

• [x] [POST] Creates a new manufacturer
• [x] [GET] Get a list of all manufacturers
• [x] [PUT] Updates a manufacturer
• [x] [GET] Get a manufacturer
• [x] [DEL] Deletes a manufacturer

• [x] [POST] Creates a new cpu
• [x] [GET] Get a list of all cpus
• [x] [PUT] Updates a cpu
• [x] [GET] Get a cpu
• [x] [DEL] Deletes a cpu

• [x] [POST] Creates a new hdd type
• [x] [GET] Get a list of all hdd types
• [x] [PUT] Updates a hdd type
• [x] [GET] Get a hdd type
• [x] [DEL] Deletes a hdd type

• [ ] [POST] identifies items

• [ ] [POST] Creates an email account
• [ ] [GET] List accounts of company
• [ ] [GET] Gets an account
• [ ] [PUT] Edit an accounts
• [ ] [DEL] Deletes an account
• [ ] [GET] List account types

• [ ] [PUT] Gets a list of vacation requests
• [ ] [GET] Gets a list of absence/custom types
• [ ] [POST] creates a vacation request
• [ ] [PUT] updates a vacation request
• [ ] [DEL] deletes a vacation request
• [ ] [GET] gets the available vacation days per year
• [ ] [POST] sets the available vacation days per year

• [ ] [PUT] List of user items
• [ ] [GET] Number of unseen events
• [ ] [POST] Marks all as seen

• [x] [POST] Creates a domain -- This option is experiencing a error right now, Waiting for Support
• [x] [GET] Gets a single domain
• [x] [PUT] Updates a domain
• [x] [DEL] Deletes a domain
• [x] [GET] List of domains of a company

• [x] [PUT] Get a list of software licenses
• [x] [POST] Creates a software license
• [x] [GET] Gets a single software license by id
• [x] [PUT] Updates a software license
• [x] [DEL] Deletes a software license
• [x] [GET] Gets all software license types
• [x] [POST] Creates a new software license type
• [x] [GET] Gets a single software license type
• [x] [PUT] Updates a software license type
• [x] [DEL] Deletes a software license type

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.