FrontifyInstall

Overview

This node interacts with the Frontify platform, specifically to manage folders within a selected library. The "Folder: List" operation retrieves all folders from a specified library in Frontify, including basic folder details and some asset information inside each folder.

Common scenarios where this node is useful include:

• Automating the retrieval of folder structures for digital asset management workflows.
• Synchronizing or auditing folder contents between Frontify and other systems.
• Displaying or processing folder metadata and contained assets in downstream automation steps.

For example, you could use this node to list all folders in a marketing library to generate reports on asset organization or to trigger further processing on assets grouped by folder.

Properties

Output

The output JSON array contains folder objects retrieved from the selected library. Each folder object includes:

• id: Unique identifier of the folder.
• name: Folder name.
• assets: An object containing an items array listing assets inside the folder, each with at least a title.
• Other metadata such as creator info, creation date, and breadcrumbs are not included in the list operation output but may be available in other operations.

The node does not output binary data for this operation.

Example output snippet (simplified):

[
  {
    "id": "folder123",
    "name": "Marketing Materials",
    "assets": {
      "items": [
        { "title": "Logo.png" },
        { "title": "Brand Guidelines.pdf" }
      ]
    }
  },
  {
    "id": "folder456",
    "name": "Product Images",
    "assets": {
      "items": []
    }
  }
]

Dependencies

• Requires an API authentication token credential to access Frontify's GraphQL API.
• The node uses a GraphQL query to fetch libraries and folders.
• The domain URL can be customized via additional options if using a non-default Frontify instance.
• No other external dependencies are required.

Troubleshooting

• Authentication errors: Ensure the provided access token is valid and has sufficient permissions to read library folders.
• Empty folder list: Verify that the selected library ID is correct and that the library contains folders.
• API request failures: Check network connectivity and that the domain URL is correctly set if customized.
• Load libraries failure: If the dynamic loading of libraries fails, confirm that the user’s account has access to brands and libraries in Frontify.

If the node throws errors related to GraphQL queries, inspect the error message for permission issues or invalid IDs.

Links and References

• Frontify API Documentation (for GraphQL API details)
• Frontify Platform official site