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 generating tasks based on triggers.
For example, you could use this node to:
- Automatically create a task in a project when a new support ticket is received.
- Add recurring tasks with specific due dates and priorities.
- Organize tasks into buckets and set detailed metadata like descriptions, progress, and colors.
Properties
| Name | Meaning |
|---|---|
| Project Title or ID | The project where the task will be created. Choose from a searchable list or specify a project ID. |
| Task Title | The title or name of the task to create. |
| Bucket ID | (Optional) The ID of the bucket within the project to place the task into. |
| Description | (Optional) A detailed description of the task. |
| Done | (Optional) Whether the task is marked as completed upon creation (true/false). |
| Due Date Time | (Optional) The due date and time for the task in RFC3339 format. |
| End Date Time | (Optional) The end date and time for the task in RFC3339 format. |
| Favorite | (Optional) Whether the task is marked as a favorite (true/false). |
| Percent Done | (Optional) Progress of the task as a decimal between 0 (0%) and 1 (100%). |
| Priority | (Optional) Task priority level from 1 (normal) to 5 (highest urgency). |
| Repeat After | (Optional) Number of seconds after which the task repeats. |
| Repeat Mode | (Optional) How the repeating task behaves: repeat after amount, monthly repeat, or repeat from current date. Options: - Repeat After Amount - Repeat Monthly - Repeat From Current Date |
| Start Date Time | (Optional) The start date and time for the task in RFC3339 format. |
| Task Color | (Optional) Hex color code to visually identify the task. |
Output
The node outputs JSON data representing the newly created task object returned by the Vikunja API. This includes all task details such as its ID, title, description, status flags, dates, priority, and any other metadata set during creation.
If the API supports binary data related to tasks (e.g., attachments), it would be included accordingly, but this node primarily handles JSON task data.
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 the request.
- Permission errors: The API user must have permission to create tasks in the specified project.
- Missing required fields: The "Task Title" and "Project" are mandatory; omitting them will cause validation errors.