awork icon

awork

Automate your workflows with the awork API

Overview

The Project Task → Add Comment operation in this n8n node allows you to add a comment to a specific task within the Awork platform. This is useful for automating collaboration workflows, such as leaving automated status updates, feedback, or notifications on tasks as part of a larger project management process.

Practical examples:

  • Automatically post a comment when a task reaches a certain stage.
  • Add notes from another system (e.g., CRM or support ticket) directly to an Awork task.
  • Notify team members by tagging them in comments via automation.

Properties

Display Name Type Meaning
Task ID String The unique identifier of the task to which the comment will be added.
Comment Message String The content/message of the comment to be posted on the specified task.

Output

The output will contain a json field with details about the newly created comment. While the exact structure depends on the Awork API response, it typically includes:

{
  "id": "string",                // Unique identifier of the comment
  "message": "string",           // The comment message/content
  "createdAt": "string",         // Timestamp when the comment was created
  "createdBy": {                 // Information about the user who created the comment
    "id": "string",
    "name": "string"
  },
  // ...other fields as provided by the Awork API
}

Dependencies

  • External Service: Requires access to the Awork API.
  • API Key: You must configure valid Awork API credentials (aworkApi) in your n8n instance.
  • n8n Configuration: No additional configuration beyond standard credential setup is required.

Troubleshooting

Common issues:

  • Invalid Task ID: If the provided Task ID does not exist or is incorrect, the node may return an error indicating that the task could not be found.
  • Missing Permissions: If the API key used does not have permission to add comments to the specified task, you may receive a permissions error.
  • Empty Comment Message: Submitting an empty comment message may result in a validation error from the API.

Error messages and resolutions:

  • "Task not found": Check that the Task ID is correct and exists in your Awork workspace.
  • "Unauthorized" or "Forbidden": Ensure your API credentials are valid and have sufficient permissions.
  • "Comment message is required": Make sure the Comment Message property is filled in.

Links and References

Discussion