npm package: @filespin-io/n8n-nodes-filespin
Description: n8n community node for FileSpin DAM — upload, tag, search, resize, and share digital assets via OAuth2
Latest version: 1.0.0

# n8n-nodes-filespin

[FileSpin](https://filespin.io) community node for [n8n](https://n8n.io) — upload, tag, search, resize, and share digital assets via OAuth2.

FileSpin is a B2B Digital Asset Management (DAM) platform with AI capabilities including auto-tagging, face recognition, background removal, on-demand image transformation, and branded share pages.

## Installation

1. In your n8n instance, go to **Settings > Community Nodes**
2. Click **Install**
3. Enter `n8n-nodes-filespin`
4. Click **Install**

## Credentials

This node uses **OAuth2** to connect to your FileSpin account.

1. Add a **FileSpin** node to your workflow
2. Click **Create New Credential**
3. Select your **Environment** (Production or Development)
4. Enter your **Client ID** and **Client Secret** (provided by FileSpin)
5. Click **Sign in with FileSpin** to authorize

## Operations

### FileSpin Node (Actions)

| Resource | Operation | Description |
|----------|-----------|-------------|
| **Asset** | Upload from URL | Import a file from any public URL |
| **Asset** | Upload File | Upload a file from a previous workflow step |
| **Asset** | Get Info | Get complete asset details and metadata |
| **Asset** | Update Metadata | Add or update custom metadata (Append/Replace) |
| **Asset** | Generate Marketplace Image | CDN URL for platform-optimized images (Amazon, Shopify, etc.) |
| **Asset** | Generate Social Media Kit | URLs for all social media platforms at once |
| **Asset** | Get Download Link | Generate a signed download URL |
| **Asset** | Search | Search assets by keyword, type, date range, schema |
| **Addon** | Remove Background | Remove image background (returns new asset or conversion) |
| **Addon** | Index Faces | Detect and index faces for face search |
| **Addon** | Get Face Index Status | Check face indexing progress |
| **Addon** | Get Auto Tags | Retrieve AI-generated labels and tags |
| **Addon** | Search by Face | Find matching faces across indexed assets |
| **Collection** | Create | Create a new asset collection |
| **Collection** | Add Assets | Add assets to an existing collection |
| **Collection** | Find | Search collections by name |
| **Share** | Create Share Page | Create a branded share page for external distribution |

### FileSpin Trigger Node (Webhooks)

| Event | Description |
|-------|-------------|
| New Asset Uploaded | Fires when a new asset is uploaded |
| Asset Processing Complete | Fires when asset processing finishes (most useful) |
| Asset Updated | Fires when asset metadata changes |
| Asset Deleted | Fires when an asset is moved to trash |
| Asset Processing Failed | Fires when processing encounters an error |
| Addon Processing Complete | Fires when an addon (bg removal, face index, etc.) finishes |

## Example Workflow

```
[FileSpin Trigger: Asset Processed]
  -> [FileSpin: Get Auto Tags]
  -> [FileSpin: Update Metadata (append AI tags)]
  -> [FileSpin: Generate Marketplace Image (Shopify)]
  -> [Slack: Notify team]
```

## Resources

- [FileSpin Documentation](https://docs.filespin.io)
- [FileSpin Website](https://filespin.io)
- [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)

## License

[MIT](LICENSE)