n8n-nodes-hubstaff

A community node for n8n that integrates with the Hubstaff API V2 to manage projects and tasks.

Features

• User Management

  • Get current user information

• Organization Management

  • List all organizations

• Projects Management

  • List all projects for an organization
  • Create new projects

• Tasks Management

  • List all tasks for an organization
  • List all tasks for a project
  • Create new tasks

Installation

1. Install the package:

npm install n8n-nodes-hubstaff

2. In your n8n instance, go to Settings > Community Nodes
3. Add the package n8n-nodes-hubstaff

Configuration

Credentials

You need to configure Hubstaff API credentials:

1. Go to Hubstaff Developer Portal
2. Generate a Personal Access Token (Refresh Token)
3. In n8n, create new credentials of type "Hubstaff API V2"
4. Enter your Personal Access Token (Refresh Token)
5. Enter your Organization ID (you can find this by using the Organization -> Get All operation)

Note: The Personal Access Token is actually a refresh token that gets automatically exchanged for an access token when making API calls. The Organization ID is automatically used from credentials for operations that require it.

Task Status Values

When filtering tasks by status, the following values are available:

• active: Active task
• archived: Archived task (completed or closed)
• archived_native_active: Archive of a task that was originally active
• archived_native_deleted: Archive of a task that has been deleted

Member Roles and Permissions

When retrieving organization members, the following information is available:

Membership Roles:

• owner: Organization owner with full permissions
• manager: Organization manager (cannot access financial features)
• user: Organization user with project-based permissions

Effective Roles:

• organization_owner: Organization owner
• organization_manager: Organization manager
• project_manager: User with manager role on all projects
• project_user: User with user role on all projects
• project_viewer: User with viewer role on all projects
• by_project: User with mixed roles across projects
• unassigned: User with no assigned role or project memberships

Trackable Status:

• false: Time tracking explicitly disabled
• true: Time tracking allowed
• viewer: Time tracking allowed but limited by project viewer role

Usage

User

Get Current User

• Resource: User
• Operation: Get

Organizations

Get All Organizations

• Resource: Organization
• Operation: Get All

Projects

Get All Projects

• Resource: Project
• Operation: Get All
• Optional fields:
  • Status Filter (All, Active, Archived)

Create Project

• Resource: Project
• Operation: Create
• Required fields:
  • Project Name
• Optional fields:
  • Project Description

Tasks

Get All Tasks

• Resource: Task
• Operation: Get Many
• Optional fields:
  • Project ID (to get tasks for specific project, otherwise uses Organization ID from credentials)
  • Status Filter (All, Active, Archived, Archived Native Active, Archived Native Deleted)

Create Task

• Resource: Task
• Operation: Create
• Required fields:
  • Project ID
  • Task Summary
  • Assignee ID
• Optional fields:
  • Task Description

Members

Get All Members

• Resource: Member
• Operation: Get Many
• Returns organization members with their roles and permissions

API Version

This node uses Hubstaff API V2 which is the current and supported version. The V1 API has been deprecated.

Base URL: https://api.hubstaff.com/v2

API Documentation

For more information about the Hubstaff API V2, visit: https://developer.hubstaff.com/docs/hubstaff_v2

Development

Prerequisites

• Node.js 18+
• npm or yarn

Setup

1. Clone the repository
2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Run linting:

npm run lint

Testing

To test the node locally:

1. Build the project
2. In your n8n development environment, add the local path to community nodes

License

MIT

Support

For issues and feature requests, please create an issue in the GitHub repository.