Description
n8n-nodes-filespin
FileSpin community nodes for n8n — upload, tag, search, resize, and share digital assets via OAuth2.
—
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
Contributing
Contributions, issues, and feature requests are welcome. Feel free to open an issue or submit a pull request on GitHub.
