HumHub icon

HumHub

Consume HumHub API (v.0.1.8)
Join our community

Actions126

Overview

This node operation creates a new task in the HumHub platform within a specified content container. It allows users to define various task attributes such as title, description, scheduling details, assigned and responsible users, reminders, and visibility settings. This operation is useful for automating task management workflows, integrating task creation into broader automation processes, and managing tasks programmatically in HumHub.

Use Case Examples

  1. Creating a task with a title and description in a specific container.
  2. Setting up a scheduled task with start and end dates and times.
  3. Assigning users and responsible users to a task.
  4. Adding reminders and setting the task as public or private.

Properties

Name Meaning
Authentication Method of authentication to use for the API request (Basic Auth or JWT Token).
ID The ID of the content container where the task will be created.
Task Title The title of the task to be created.
Task Additional Fields Additional optional fields for the task such as description, task list ID, scheduling options, reminders, calendar mode, assigned and responsible users, and review status.
Start Date Start date of the task, required if scheduling is enabled.
Start Time Start time of the task, required if scheduling is enabled and the task is not all day.
End Date End date of the task, required if scheduling is enabled.
End Time End time of the task, required if scheduling is enabled and the task is not all day.
Task Form Additional Fields Additional form fields for the task such as public visibility, time zone, and checklist items.

Output

JSON

  • Task
    • id - The unique identifier of the created task.
    • title - The title of the created task.
    • description - The description of the created task.
    • scheduling - Indicates if the task has scheduling enabled.
    • start_date - The start date of the task.
    • start_time - The start time of the task.
    • end_date - The end date of the task.
    • end_time - The end time of the task.
    • assignedUsers - List of users assigned to the task.
    • responsibleUsers - List of users responsible for the task.
    • selectedReminders - List of reminder IDs for the task.
  • TaskForm
    • is_public - Indicates if the task is public.
    • timeZone - The time zone of the task.
    • newItems - Checklist items for the task.

Dependencies

  • HumHub API

Troubleshooting

  • Ensure that the 'ID' of the content container is provided and valid, as it is required to create a task.
  • If 'Selected Reminders' are provided, they must be numbers separated by commas; otherwise, an error will be thrown.
  • If scheduling is enabled, 'Start Date' and 'End Date' must be provided. If the task is not all day, 'Start Time' and 'End Time' are also required.
  • Authentication credentials must be correctly configured for either Basic Auth or JWT Token, depending on the selected authentication method.

Links

Discussion