AvantGuard - HuduInstall

Overview

The Create Procedure Task operation for the Procedure Tasks resource allows you to create a new task within a specified procedure in Hudu via AvantGuard's n8n integration. This node is useful for automating the creation of tasks as part of workflow procedures, such as onboarding checklists, recurring maintenance steps, or project management processes.

Practical examples:

• Automatically generate a set of tasks when a new client is onboarded.
• Assign tasks to specific users based on procedure templates.
• Set due dates and priorities for tasks created as part of automated workflows.

Properties

Name	Type	Meaning
Name	String	The name of the task.
Description	String	A detailed description of the task.
Procedure Id	Number	The ID of the procedure this task belongs to.
Position	Number	The position of the task in the procedure.
User Id	Number	The ID of the user assigned to the task.
Due Date	String	The due date for the task.
Priority	Options	The priority level of the task. Possible values: Unsure, Low, Normal, High, Urgent.
Assigned Users	JSON	An array of user IDs assigned to the task.

All these properties are optional and can be provided under "Additional Body Fields".

Output

The node returns the response from the Hudu API after creating the procedure task. The output will be a json object containing details of the newly created task, which typically includes fields such as:

• id: Unique identifier of the task.
• name: Name of the task.
• description: Description of the task.
• procedure_id: Associated procedure ID.
• position: Task order in the procedure.
• user_id: Assigned user ID.
• due_date: Due date for the task.
• priority: Priority level.
• assigned_users: Array of assigned user IDs.
• Additional metadata as returned by the API.

Note: The exact structure may vary depending on the API response.

Dependencies

• External Service: Requires access to a Hudu instance with API enabled.
• API Key/Credentials: Needs valid credentials (avantguardHuduApi) configured in n8n, including the base URL and authentication token.
• n8n Configuration: Ensure the credential type avantguardHuduApi is set up in your n8n instance.

Troubleshooting

Common issues:

• Invalid Credentials: If the API key or base URL is incorrect, the node will fail with an authentication error. Double-check your credentials configuration.
• Missing Required Fields: If required fields for the API (such as procedure_id) are not provided, the API may return a validation error.
• Malformed JSON in Assigned Users: If the "Assigned Users" field is not a valid JSON array, the request will fail. Ensure it is properly formatted (e.g., [1,2,3]).
• Network/Connection Errors: If n8n cannot reach the Hudu API endpoint, check network connectivity and firewall settings.

Error messages and resolutions:

• 401 Unauthorized: Check your API credentials.
• 400 Bad Request: Review input fields for missing or invalid data.
• 404 Not Found: Ensure the referenced procedure or user IDs exist in Hudu.

Links and References

• Hudu API Documentation
• n8n Documentation: Custom Nodes
• AvantGuard n8n OpenAPI Node