n8n-nodes-teamhub

An n8n community node for the TeamHub business management API — tasks, customers, invoices, products, projects, notes, files, passwords, taxes, tables, the built-in assistant and more.

Installation · Credentials · Operations · Notes

Installation

In n8n, go to Settings → Community Nodes → Install and enter:

n8n-nodes-teamhub

Or install it manually in your n8n custom folder:

npm install n8n-nodes-teamhub

Credentials

Create an API key in TeamHub under Profile → API Keys, then add a TeamHub API credential:

| Field | Required | Description | | --- | --- | --- | | Base URL | yes | e.g. https://tool.hbj-solutions.com | | API Key | yes | th_…, sent as the X-API-Key header | | Email / Password | no | Only needed for the few endpoints that require a browser session (see below). The node signs in automatically and reuses the cookie for the whole execution. |

Operations

| Resource | Operations | | --- | --- | | Task | Get Many · Create · Update · Delete | | Customer | Get · Get Many · Create · Update · Delete | | Invoice | Get Many · Create (line items as fields or JSON) · Update · Delete | | Product | Get Many · Create · Update · Delete | | Project | Get Many · Create · Update · Delete | | Note | Get Many · Create · Update · Delete | | Event | Get Many · Create · Update · Delete | | Password | Get Many · Create · Update · Reveal · Delete | | File | Get Many · Upload · Download · Update · Delete | | File Folder | Get Many · Create · Update · Delete | | Table | Get · Get Many · Create · Delete | | Tax | Get/Create/Update/Delete Entry · Get/Create/Update/Delete Deadline · Get Summary · Get/Update Profile | | STSS | Get Many · Create · Delete · Get Suggestions · Apply Suggestion | | Dashboard | Get · Get Day Plan · Get Activities · Search | | Assistant | Ask · Respond to Permission · Reattach · Get Runs · Get Run · Cancel Run · Get/Clear History | | Transcription | Transcribe an audio file with the on-premise Whisper model | | API Key | Get Many · Create · Revoke | | Profile | Get · Update | | User | Get Many (team members, for assignee IDs) | | Auth | Get Current User · Log In · Register · Log Out | | Admin | Get Users (requires a session, admins only) |

Options

Available on every operation:

• Split Lists Into Items — output one n8n item per record instead of a single item holding the whole response. Off by default so existing workflows keep their shape.
• Ignore SSL Issues — for self-hosted instances with a self-signed certificate.

Notes

• Assistant runs. The /api/assistant endpoint streams newline-delimited JSON, but the server usually closes the connection before the agent has finished. The Ask, Reattach and Respond to Permission operations therefore keep following the run through its replay endpoint until it completes (Wait for Completion, on by default). The output carries runId, status, the assembled text and the full events array.
• Session-only endpoints. GET /api/admin/users is rejected for API-key requests. Fill in email and password on the credential to use it.
• Tax categories are a server-side enum. Confirmed income values are REVENUE_PRODUCT, REVENUE_SERVICE and REVENUE_OTHER; an unknown value makes the API answer 500.
• Deletes are archives. Every Delete operation archives the record rather than removing it permanently.

Compatibility

Tested against n8n 1.8x with n8n-workflow 1.82. Requires Node.js 18.10 or newer.

License

MIT