Docs
Search K

Appearance

ACC Add Folder ​

Overview ​

The ACC Add Folder node creates a new folder within an Autodesk Construction Cloud (ACC) project at the specified full folder path. This allows workflows to programmatically build out required folder structures in ACC for project setup and automation purposes.

Purpose ​

Use this node to:

  • Create a folder in an Autodesk Construction Cloud project at a defined path.
  • Ensure folder structures exist before uploading files or performing file-based automation tasks.

Inputs ​

FieldDescriptionExample / Notes
Hub NameThe exact name of the ACC hub (e.g. your company's Autodesk account hub name)."MyCompany Hub"
Project NameThe exact name of the ACC project within the hub."Sydney Office Fitout"
Folder Full PathThe full folder path to create, including parent folders if applicable."Project Files/Design/Structural/IFC Exports"

Outputs ​

Output VariableDescription
AccFolderReturns a BIMDocsProjectFolder object containing details of the created folder, including its GUID and full path.

Behavior ​

  1. Validates Inputs: Ensures all required inputs are provided.
  2. Service Account Access: Retrieves the Autodesk service account token configured in the system.
  3. Hub and Project Lookup: Searches for the specified hub and project.
  4. Folder Creation: Creates the folder at the specified path. If parent folders do not exist, they will be created automatically.
  5. Outputs Folder Object: Stores the resulting folder object in the AccFolder output variable for use in downstream tasks.

Example Usage ​

  • Workflow Step: Create folder structure for a new project setup.
  • Folder Full Path: Project Files/Design/Mechanical/Equipment Schedules
  • Result: The specified folder hierarchy is created within the target project.

Errors and Handling ​

This node will fail if:

  • The provided Hub Name or Project Name does not exist.
  • The Autodesk service account token is missing or invalid.
  • The folder cannot be created due to API permission errors or invalid paths.

Returned Errors:

  • Failed to get Hub name: [hub]
  • Failed to get Project name: [project]
  • Failed to create folder: [path]
  • Required Service Accounts not found

Implementation Notes ​

  • Uses the AccDocsService to interact with Autodesk Construction Cl

Tentech 2024