Frontify icon

Frontify

Interact with Frontify

Actions20

Account → List User Groups

AI-generated

Overview

This node integrates with the Frontify platform, enabling users to interact programmatically with various Frontify resources such as assets, projects, folders, accounts, brands, and creatives. Specifically, for the Account resource and the List User Groups operation, it retrieves a list of user groups within the authenticated Frontify account, including each group's ID, name, and the users belonging to those groups.

Common scenarios where this node is beneficial include:

  • Automating user group management workflows.
  • Synchronizing Frontify user groups with other systems.
  • Reporting or auditing user group memberships.
  • Building custom dashboards or integrations that require knowledge of user groups.

Example use case: A marketing team wants to automatically fetch all user groups and their members from Frontify to sync with an internal access control system.

Properties

Name Meaning
Authentication Means of authenticating with the service. Currently supports "Access Token" authentication.
Additional Options Optional parameters including:
• Token (string, password): An API token for authentication.
• Domain (string): The Frontify domain URL, defaulting to https://example.frontify.com.

Note: For the List User Groups operation under the Account resource, no additional input properties are required beyond authentication.

Output

The output JSON array contains objects representing user groups in the Frontify account. Each user group object includes:

  • id: The unique identifier of the user group.
  • name: The name of the user group.
  • users: An object containing:
    • items: An array of user objects, each with:
      • id: The user's unique identifier.
      • name: The user's full name.

Example output snippet:

[
  {
    "id": "group-id-123",
    "name": "Marketing Team",
    "users": {
      "items": [
        {
          "id": "user-id-1",
          "name": "Alice Smith"
        },
        {
          "id": "user-id-2",
          "name": "Bob Johnson"
        }
      ]
    }
  },
  ...
]

No binary data output is produced by this operation.

Dependencies

  • Requires an active Frontify account with appropriate API access.
  • Requires an API authentication token (access token) configured in n8n credentials.
  • Uses GraphQL queries to communicate with the Frontify API endpoint.
  • The domain URL can be customized via the "Domain" property if needed.

Troubleshooting

  • Authentication errors: If the node fails due to invalid or missing tokens, verify that the provided access token is correct and has sufficient permissions.
  • API endpoint issues: Ensure the domain URL is correctly set if using a custom Frontify instance.
  • Empty results: If no user groups are returned, confirm that the authenticated account actually has user groups defined.
  • Rate limiting or network errors: These may occur depending on Frontify API limits or connectivity; retry or check network status.
  • GraphQL errors: Any malformed queries or permission issues will result in errors; review error messages for details.

If the node is set to continue on fail, errors for individual items will be included in the output for debugging.

Links and References

Discussion