n8n-nodes-t0ggles

A lightweight n8n community node that connects n8n to the t0ggles tasks API.

Requirements

• You must be an administrator of your t0ggles board.
• Generate an API key in your board by navigating to Board Settings → Services → API Key.

Installation

Install the package in your n8n instance directory (available on npm at https://www.npmjs.com/package/n8n-nodes-t0ggles):

npm install n8n-nodes-t0ggles

After installation, restart n8n so the new credential and node types are loaded.

Upgrading to 1.1.0

1.1.0 restructures the node around a single Operation dropdown (e.g. Task — Get Many, Task — Create, Dependency — Create) so n8n's parameter resolution works reliably and only the fields for the chosen operation are shown. This is a breaking UI change: the old Resource and separate Task Operation / Dependency Operation selectors are removed. Reconfigure existing t0ggles nodes by choosing the new operation and re-entering parameters, or add a fresh node and set it up from scratch.

Upgrading to 1.0.0

Versions before 1.0.0 had n8n compatibility issues (e.g. “parameter dependencies” errors). 1.0.0 fixes those and aligns with the current t0ggles API. Because the node’s internals changed, any existing t0ggles nodes in your workflows need to be reconfigured: re-select Resource and Operation, re-enter task or dependency details, and save. Or remove the node and add a new one, then configure it from scratch.

Credential Configuration

1. In n8n, go to Credentials and create new credentials of type t0ggles API.
2. Paste the API key you generated in t0ggles into the API key field.
3. Save the credential and test the connection.

Using the Node

• Node name: t0ggles
• Operation (single dropdown): choose the action; only the parameters for that operation are shown.
  • Task — Get Many: Retrieve tasks. Use Task Filters to filter by project, status, type (task/milestone), milestone ID, assigned user, etc. For custom property filters, use the Custom Property Filters (JSON) field, e.g. { "prop_Region": "North America" }.
  • Task — Create: Create one or more tasks or milestones. Use Tasks to Create. Required: title, project key, description type, description content. Optional (Additional Fields): type, milestone linking, status, assignee, priority, tags, dates, custom properties (propertiesJson).
  • Task — Update: Update existing tasks. Use Tasks to Update (identify by ID or project key + key; set Update Fields as needed).
  • Dependency — Get Many: List dependencies. Use Dependency Filters (task ID or project key + key).
  • Dependency — Create: Create a dependency. Set Predecessor Task (Create) and Successor Task (Create); optionally Dependency Additional Fields (e.g. lag days).
  • Dependency — Delete: Delete a dependency. Use Dependency Identification (by dependency ID or by task identifiers) and the corresponding fields.

After installation and configuration, the node appears in your editor under t0ggles.

“Workflow has issues” or won’t run

If n8n says the workflow has issues and can’t be executed:

1. Credentials — Open the t0ggles node and ensure Credential to connect with is set to a valid t0ggles API credential (create one under Credentials if needed).
2. Node errors — Check for a red indicator on the node; hover it for the error message and fix the reported field (e.g. required value missing).
3. Re-add the node — Remove the t0ggles node from the canvas, add a new t0ggles node, choose Operation and fill in the shown fields, then save the workflow.

Development

Clone the repository and install dependencies:

npm install

Compile the TypeScript sources:

npm run build

To verify the package that will be published to npm, you can run:

npm pack

Support

Report issues or contribute via the GitHub repository: https://github.com/ghotso/n8n-nodes-t0ggles.