Package Information
Documentation
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
- In your n8n instance, go to Settings > Community Nodes.
- Click Install a community node.
- Enter
n8n-nodes-filespinand 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.