Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Overview

This node operation removes managers associated with a specific custom field value within an account. It is useful in scenarios where you need to revoke managerial permissions or roles linked to a particular custom field setting, for example, when restructuring teams or updating access controls based on custom attributes.

Practical examples include:

  • Removing all managers assigned to a project phase identified by a custom field value.
  • Revoking managerial rights from users tagged with a certain department code stored as a custom field.

Properties

Name Meaning
Account Id Identifier of the account where the custom field and its values exist.
Custom Field Id Identifier of the custom field from which managers will be removed.
Custom Field Value Id Identifier of the specific value of the custom field that determines which managers to remove.

Output

The node outputs JSON data representing the result of the removal operation. This typically includes confirmation of success or details about the affected managers. The exact structure depends on the API response but generally confirms which managers were removed or if the operation failed.

No binary data output is involved.

Dependencies

  • Requires an API key credential for authentication to the external service managing accounts and custom fields.
  • The node interacts with an external API endpoint configured via base URL and headers (e.g., Accept and Content-Type set to application/json).
  • Proper configuration of credentials and API access is necessary for successful execution.

Troubleshooting

  • Common issues:

    • Invalid or missing Account Id, Custom Field Id, or Custom Field Value Id can cause the operation to fail.
    • Insufficient permissions or invalid API credentials may lead to authorization errors.
    • Network connectivity problems can prevent communication with the external API.
  • Error messages and resolutions:

    • "Unauthorized" or "Authentication failed": Verify that the API key credential is correctly configured and has sufficient permissions.
    • "Resource not found": Check that the provided Account Id, Custom Field Id, and Custom Field Value Id are correct and exist.
    • "Bad Request": Ensure all required parameters are provided and valid.
    • Timeouts or network errors: Confirm network connectivity and API availability.

Links and References

  • Refer to the external API documentation for managing custom fields and user roles.
  • n8n documentation on configuring API credentials and error handling.

Discussion