vntana

n8n community node for VNTANA 3D content management platform

Package Information

Released: 4 mo ago
Downloads: 32 weekly / 138 monthly
Latest Version: 0.5.1
Author: VNTANA

Available Nodes

VNTANA icon
VNTANA
Interact with VNTANA 3D content management platform

Documentation

n8n-nodes-vntana

This is an n8n community node for VNTANA, a product content platform that automates and scales 3D content. It enables n8n workflows to interact with VNTANA's Admin API for automating workflows with 3D products, renders, and attachments.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

npm

npm install n8n-nodes-vntana

Manual Installation

  1. Clone or download this repository
  2. Run npm install and npm run build
  3. Link the package: npm link
  4. In your n8n custom nodes directory (~/.n8n/custom):
    npm init -y  # if not already initialized
npm link n8n-nodes-vntana
  5. Restart n8n

Credentials

To use this node, you need to configure VNTANA API credentials:

Field Required Description
Email Yes Email address for your VNTANA account
Password Yes Password for your VNTANA account
Organization Slug Yes The slug from your platform URL (e.g. acme-corp in app.vntana.com/acme-corp/...)
Default Workspace UUID No Default workspace to use when not specified in an operation
API Base URL No Override the default API host (for staging/test environments)

Obtaining Credentials

Enter your email, password, and your organization's slug. The node handles the rest:

  1. Logs in with email/password to get an initial auth token.
  2. Resolves your Organization UUID by matching the slug against the orgs returned by GET /v1/organizations.
  3. Refreshes the token with that UUID to get an org-specific token.
  4. Uses that org-specific token on every subsequent request, refreshing automatically when it expires.

For detailed authentication steps, see VNTANA API Authentication.

Operations

Product

Operation Description
Search Search for products in a workspace with filters
Download Model Download a 3D model file (GLB, USDZ, FBX, OBJ, STEP)

Search Filters

  • Search term (text search)
  • Status (Draft, Live Public, Live Internal, Approved, Rejected, Waiting Review)
  • Conversion status (Pending, Converting, Completed, Failed, No Asset)
  • Name (exact match)
  • Tag UUIDs

Render

Operation Description
Download Download renders (still images or turntable videos) for a product
Upload Upload a render image/video to a product

Attachment

Operation Description
Upload Upload an attachment file to a product

Usage Examples

Search Products

  1. Add the VNTANA node to your workflow
  2. Select Product resource and Search operation
  3. Enter your Workspace UUID
  4. Optionally add filters (search term, status, etc.)
  5. Execute to retrieve matching products

Download a 3D Model

  1. Add the VNTANA node to your workflow
  2. Select Product resource and Download Model operation
  3. Enter the Product UUID and Workspace UUID
  4. Select the format (GLB, USDZ, FBX, OBJ, or STEP)
  5. Execute to download the model as binary data

Upload a Render

  1. Add a node that provides binary data (e.g., HTTP Request, Read Binary File)
  2. Add the VNTANA node
  3. Select Render resource and Upload operation
  4. Enter the Product UUID and Workspace UUID
  5. Specify the binary property name containing your file
  6. Execute to upload the render to VNTANA

Compatibility

  • n8n version: 1.0.0+
  • Node.js version: 18.x+

Resources

Development

# Install dependencies
npm install

# Build the node
npm run build

# Watch mode for development
npm run dev

# Lint the code
npm run lint

# Fix lint issues
npm run lintfix

License

MIT

Discussion