Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Overview

This node operation allows you to add managers for a specific custom field value within an account. It is useful in scenarios where you want to assign or update managerial roles linked to particular custom field values, enabling more granular control over access or responsibilities based on custom data attributes.

For example, if you have a custom field representing project teams and want to designate certain users as managers for a specific team (custom field value), this operation facilitates that assignment programmatically.

Properties

Name Meaning
Account Id Identifier of the account where the custom field exists.
Custom Field Id Identifier of the custom field to which managers will be added.
Custom Field Value Id Identifier of the specific value within the custom field for which managers are assigned.
Body JSON object containing additional data required by the API to add managers.

Output

The node outputs JSON data representing the result of the operation, typically confirming the addition of managers to the specified custom field value. The exact structure depends on the API response but generally includes status information and details about the updated custom field value.

No binary data output is expected from this operation.

Dependencies

  • Requires an API key credential for authentication with the external service.
  • The node expects a base URL configuration for the API endpoint.
  • The operation uses JSON-formatted request bodies.

Troubleshooting

  • Missing or invalid identifiers: Ensure that Account Id, Custom Field Id, and Custom Field Value Id are correctly provided and correspond to existing entities in the system.
  • Invalid JSON in Body: The Body property must contain valid JSON. Invalid JSON will cause parsing errors.
  • Authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
  • API endpoint issues: Confirm that the base URL is correct and the external service is reachable.

Common error messages may include:

  • "Unauthorized" or "Authentication failed": Check API credentials.
  • "Not Found": Verify that the provided IDs exist.
  • "Bad Request": Inspect the JSON body for correctness.

Links and References

  • Refer to the external API documentation for detailed schema of the request body and response.
  • n8n documentation on using JSON input properties and API credentials.

Discussion