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
- Task Actions
- Team Actions
- Webhook Actions
Overview
This node integrates with the Vikunja task management API to create new tasks within a specified project. It is useful for automating task creation workflows, such as adding tasks from form submissions, syncing tasks from other tools, or programmatically managing project work items.
Typical use cases include:
- Automatically creating tasks in Vikunja when a new issue or request is received.
- Adding tasks based on scheduled triggers or external events.
- Populating projects with predefined tasks during onboarding or project setup.
For example, you could configure this node to create a task titled "Prepare monthly report" in a specific project, setting its due date and priority automatically.
Properties
| Name | Meaning |
|---|---|
| Project Title or ID | The target project where the task will be created. Choose from a searchable list or specify an ID. |
| Task Title | The title of the task to create. This is required. |
| Additional Fields | Optional extra settings for the task: |
| - Description | A detailed description of the task. |
| - Done | Whether the task is marked as completed (true/false). |
| - Due Date Time | The due date and time for the task in RFC3339 format. |
| - Start Date Time | The start date and time for the task in RFC3339 format. |
| - End Date Time | The end date and time for the task in RFC3339 format. |
| - Task Color | A color code to visually identify the task. |
| - Favorite | Whether the task is marked as a favorite (true/false). |
| - Priority | Task priority level from 1 (normal) to 5 (highest urgency). |
| - Percent Done | Progress of the task expressed as a decimal between 0 (0%) and 1 (100%). |
| - Repeat After | Number of seconds after which the task repeats. |
| - Repeat Mode | How repeating tasks behave: |
| • Repeat After Amount (default) | |
| • Repeat Monthly | |
| • Repeat From Current Date | |
| - Bucket ID | Identifier of the bucket within the project to place the task into. |
Output
The node outputs JSON data representing the newly created task as returned by the Vikunja API. This typically includes fields such as task ID, title, description, status flags, dates, priority, and any other metadata set during creation.
If binary data were involved (not applicable here), it would represent file attachments or similar content related to the task.
Dependencies
- Requires an API key credential for authenticating with the Vikunja API.
- Needs the base URL of the Vikunja instance configured in the credentials.
- The node uses HTTP requests to communicate with the Vikunja REST API endpoints.
Troubleshooting
- Authentication errors: Ensure the API key and base URL are correctly configured in the node credentials.
- Invalid project ID: If the project does not exist or the ID is incorrect, the API will return an error. Use the project search feature to select valid projects.
- Date format issues: Dates must be in RFC3339 format; otherwise, the API may reject them.
- Permission errors: The API user must have rights to create tasks in the specified project.
- Missing required fields: The task title and project must be provided; missing these will cause validation errors.