OpenProject icon

OpenProject

Interact with OpenProject via API

Actions199

Overview

This node operation creates a new group in the OpenProject system via its API. It is useful for automating the management of user groups, such as organizing users by teams, departments, or project roles. For example, you can use this node to programmatically create groups when onboarding new projects or restructuring teams, ensuring consistent group setup without manual intervention.

Properties

Name Meaning
Name The name of the new group to be created.
Links JSON object defining related API links and methods; by default, it includes a link to add members to the group via a POST request to /api/v3/work_packages.

Output

The node outputs JSON data representing the newly created group as returned by the OpenProject API. This typically includes details such as the group's ID, name, and associated metadata. There is no binary output.

Dependencies

  • Requires an API key credential for authenticating with the OpenProject API.
  • Needs the base URL of the OpenProject instance configured in the credentials.
  • Depends on the OpenProject REST API being accessible and properly configured to accept group creation requests.

Troubleshooting

  • Authentication errors: Ensure the API key credential is valid and has sufficient permissions to create groups.
  • Invalid group name: The API may reject empty or invalid names; verify the "Name" property is correctly set.
  • API endpoint issues: Confirm the OpenProject instance URL is correct and reachable.
  • Malformed JSON in Links: If customizing the _links property, ensure the JSON is well-formed to avoid request failures.

Links and References

Discussion