Actions57
- Label Actions
- Project Actions
- Add a Team
- Add a User
- Create
- Create a Kanban Bucket
- Create a Link Share
- Create a Project View
- Delete
- Delete a Kanban Bucket
- Delete a Link Share
- Delete a Project View
- Duplicate
- Get
- Get All Link Shares
- Get All Project Views
- Get All Teams
- Get All Users
- Remove a Team From a Project
- Remove a User From a Project
- Update
- Update a Kanban Bucket
- Update a Project View
- Update a Team's Rights on a Project
- Update a User's Rights on a Project
- Team Actions
- Task Actions
- Webhook Actions
Overview
This node integrates with the Vikunja API to manage projects and their users. Specifically, the "Add a User" operation under the "Project" resource allows you to add a user to a specified project by providing the project's identifier and the user's ID. This is useful in scenarios where you want to programmatically manage team membership within projects, such as automating onboarding processes or synchronizing user access across systems.
Practical examples:
- Automatically adding new employees to relevant projects when they join a company.
- Syncing user assignments from an HR system into Vikunja projects.
- Managing project collaborators dynamically based on external triggers.
Properties
| Name | Meaning |
|---|---|
| Project Title or ID | The target project to which the user will be added. You can select a project from a searchable list or specify its ID directly. |
| User ID | The numeric identifier of the user to add to the project. |
Output
The node outputs JSON data representing the result of the API call to add a user to a project. This typically includes confirmation details about the user addition or the updated project user list. There is no indication that binary data is output by this node.
Dependencies
- Requires an API key credential for authenticating with the Vikunja API.
- The node uses the base URL configured in the credentials to send requests.
- The node depends on the Vikunja API being accessible and the provided user ID and project ID being valid.
Troubleshooting
Common issues:
- Providing an invalid or non-existent project ID or user ID will likely cause the API to return an error.
- Network connectivity problems or incorrect API URL configuration can prevent successful communication.
- Insufficient permissions for the API key may result in authorization errors.
Error messages and resolutions:
- "User not found" or similar: Verify the user ID exists in Vikunja.
- "Project not found": Confirm the project ID or selection is correct.
- Authorization errors: Check that the API key has the necessary scopes/permissions.
- Network errors: Ensure the API URL is correct and reachable from n8n.