Overview
This node integrates with the Hubstaff API to manage tasks within projects. Specifically, the "Task - Create" operation allows users to create new tasks in a specified project and assign them to a user. This is useful for automating task creation workflows, such as when new work items need to be generated based on external triggers or data sources.
Practical examples include:
- Automatically creating tasks in Hubstaff when a new issue is reported in another system.
- Generating tasks for team members based on form submissions or customer requests.
- Integrating task creation into broader automation pipelines that coordinate project management activities.
Properties
| Name | Meaning |
|---|---|
| Project ID | The unique identifier of the project where the task will be created. |
| Task Summary | A brief summary or title describing the task. |
| Task Description | An optional detailed description providing more context about the task. |
| Assignee ID | The unique identifier of the user to whom the task will be assigned. |
Output
The node outputs an array of JSON objects representing the created task(s). Each output item contains the full response from the Hubstaff API for the created task, including details such as task ID, summary, description, assignee information, status, timestamps, and other metadata returned by the API.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token (refresh token) for Hubstaff, configured via credentials in n8n.
- The organization ID must be available either from the credentials or provided indirectly through the project ID.
- The node makes HTTPS requests to the Hubstaff API endpoints to perform operations.
Troubleshooting
- Missing Refresh Token: The node requires a valid refresh token credential to obtain access tokens. If missing, it will throw an error indicating the refresh token is required.
- Invalid Project or Assignee IDs: Errors may occur if the project ID or assignee ID do not exist or the user does not have access. The node provides specific error messages prompting to verify these IDs.
- Task Integration Conflicts: If the target project has a task integration enabled (e.g., Jira, Asana), the API rejects task creation. The node detects this and suggests:
- Disabling the task integration in Hubstaff for the project,
- Using a different project without integrations, or
- Creating tasks directly in the integrated system instead of via the Hubstaff API.
- API Request Failures: Network issues or invalid credentials can cause request failures. Ensure the API key/refresh token is valid and network connectivity is stable.