Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Overview

This node operation allows you to add a member to a specific team within a group. It is useful in scenarios where you manage organizational structures, such as assigning users to teams for collaboration or access control purposes. For example, in a corporate environment, you might use this node to programmatically add an employee to a project team with defined roles.

Properties

Name Meaning
Group Id Identifier of the Group to which the team belongs.
Team Id Identifier of the Team where the member will be added.
Member Id User ID of the member to be added to the team (specific to the system, e.g., Payhawk).
Roles JSON array defining the roles granted to the team member (e.g., ["admin", "editor"]).

Output

The node outputs JSON data representing the result of the add-member-to-team operation. This typically includes confirmation details such as the updated team membership or status of the request. The output does not include binary data.

Dependencies

  • Requires an API key credential for authentication with the external service.
  • Needs configuration of the base URL for the API endpoint.
  • Depends on the external service's API that manages groups, teams, and members.

Troubleshooting

  • Common issues:
    • Invalid or missing Group Id, Team Id, or Member Id can cause the operation to fail.
    • Incorrectly formatted Roles JSON may lead to parsing errors.
    • Authentication failures if the API key or credentials are not set properly.
  • Error messages:
    • "Member not found" indicates the provided Member Id does not exist.
    • "Team not found" or "Group not found" means the specified identifiers are invalid.
    • "Unauthorized" suggests issues with API credentials; verify and update them.
  • Resolutions:
    • Double-check all IDs for correctness.
    • Validate the Roles JSON format before input.
    • Ensure API credentials are correctly configured in n8n.

Links and References

  • Refer to the external API documentation for managing groups and teams for detailed information on roles and permissions.
  • n8n documentation on setting up API credentials and HTTP request nodes for further customization.

Discussion