Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Account Teams → Add Member To A Team

AI-generated

Overview

This node operation allows you to add a member to an account team within the Payhawk system. It is useful for managing team memberships by programmatically assigning users to specific teams and defining their roles within those teams. Typical use cases include automating team management workflows, onboarding new users into teams with predefined permissions, or synchronizing team membership from external systems.

For example, when a new employee joins a company, this node can be used to automatically add them to the appropriate account team with the correct roles assigned, ensuring they have the necessary access and permissions without manual intervention.

Properties

Name Meaning
Account Id Identifier of the account to which the team belongs.
Team Id Identifier of the team to which the member will be added.
Member Id User ID in Payhawk representing the member to add to the team.
Roles JSON array specifying the roles granted to the team member (e.g., ["admin", "viewer"]).

Output

The node outputs JSON data representing the result of the add member operation. This typically includes confirmation details such as the updated team membership information or status messages returned by the Payhawk API. The output does not include binary data.

Dependencies

  • Requires an active connection to the Payhawk API.
  • Needs an API authentication token or API key credential configured in n8n to authorize requests.
  • The base URL for the Payhawk API must be set in the node credentials configuration.

Troubleshooting

  • Common issues:

    • Invalid or missing Account 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 token is invalid or expired.
    • Network connectivity problems preventing communication with the Payhawk API.
  • Error messages and resolutions:

    • "Unauthorized" or "Authentication failed": Verify that the API credentials are correctly configured and valid.
    • "Invalid input" or "Bad Request": Check that all required fields (Account Id, Team Id, Member Id, Roles) are provided and correctly formatted.
    • "Not Found": Confirm that the specified account, team, and member IDs exist in Payhawk.
    • JSON parse errors on Roles: Ensure the Roles property contains valid JSON array syntax.

Links and References

Discussion