FileSpin is a B2B Digital Asset Management (DAM) platform with built-in AI capabilities including auto-tagging, face recognition, background removal, on-demand image transformation, and branded share pages. This package provides two n8n nodes that let you integrate FileSpin into any n8n workflow:

• FileSpin — an action node with 17 operations across assets, addons, collections, and sharing.
• FileSpin Trigger — a webhook-based trigger node that reacts to asset lifecycle events in real time.

Installation

1. In your n8n instance, go to Settings > Community Nodes.
2. Click Install a community node.
3. Enter n8n-nodes-filespin and click Install.

The node will appear in the node palette under FileSpin.

Requires: n8n >=0.200.0 (self-hosted or n8n Cloud).

Authentication

This node uses OAuth2. You will need a Client ID and Client Secret from your FileSpin account — contact FileSpin support if you don't have them yet.

| Step | Action | |------|--------| | 1 | Add a FileSpin or FileSpin Trigger node to your workflow. | | 2 | Click Create New Credential and choose FileSpin OAuth2 API. | | 3 | Select your Environment — Production or Staging. | | 4 | Enter your Client ID and Client Secret. | | 5 | Click Sign in with FileSpin to complete the OAuth flow. |

The credential is shared across both nodes, so you only need to authorize once.

Nodes

FileSpin (Action Node)

| Resource | Operation | Description | |----------|-----------|-------------| | Asset | Upload from URL | Import a file from any public URL | | | Upload File | Upload a file from a previous workflow step | | | Get Info | Retrieve complete asset details and metadata | | | Update Metadata | Add or replace custom metadata fields | | | Generate Marketplace Image | Get a CDN URL optimized for a marketplace (Amazon, Shopify, Walmart, Instagram, etc.) | | | Generate Social Media Kit | Get CDN URLs for all major social platforms in one call | | | Get Download Link | Generate a signed, time-limited download URL | | | Search | Find assets by keyword, file type, date range, or schema criteria | | Addon | Remove Background | Remove the image background (save as new asset or return conversion) | | | Index Faces | Detect and index faces for later face search | | | Get Face Index Status | Check progress of face indexing | | | Get Auto Tags | Retrieve AI-generated labels and tags | | | Search by Face | Find matching faces across all indexed assets | | Collection | Create | Create a new collection | | | Add Assets | Add one or more assets to a collection | | | Find | Search collections by keyword | | Share | Create Share Page | Generate a branded, password-protected share page with download and approval options |

FileSpin Trigger (Webhook Node)

| Event | Fires when… | |-------|-------------| | New Asset Uploaded | A new asset is uploaded to FileSpin | | Asset Processing Complete | Asset processing finishes successfully (most commonly used) | | Asset Updated | Asset metadata is changed | | Asset Deleted | An asset is moved to trash | | Asset Processing Failed | Processing encounters an error | | Addon Processing Complete | An addon job (background removal, face indexing, etc.) finishes |

Example Workflow

Below is a typical automation that auto-tags new assets and publishes marketplace-ready images:

FileSpin Trigger (Asset Processed)
  → FileSpin: Get Auto Tags
  → FileSpin: Update Metadata (append AI tags)
  → FileSpin: Generate Marketplace Image (Shopify)
  → Slack: Notify team with image link

Resources

• FileSpin Workflows Guide
• FileSpin Website
• n8n Community Nodes Documentation

Contributing

Contributions, issues, and feature requests are welcome. Feel free to open an issue or submit a pull request on GitHub.

License

MIT — Copyright 2026 FileSpin