# How to Integrate the Fastio API with n8n Workflows

Guide to integrate fast api with n8n workflows: Connect n8n workflows to Fastio's API to automate file storage and collaboration for agentic teams. n8n suits technical teams linking to Fastio's REST API via HTTP Request nodes. This guide covers authentication, node configuration and examples for uploads, activity polling and AI queries.

Source: https://fast.io/resources/integrate-fastio-api-n8n-workflows/
Last reviewed: 2026-02-24

## Why Integrate Fastio API with n8n?

Fastio provides intelligent workspaces for agentic teams, with file versioning, semantic search, RAG-powered AI chat, and activity feeds for tracking events.

Use n8n low-code workflows to work with these features.

Common use cases:
* Automatically upload files from forms or emails to Fastio workspaces.
* Poll Fastio activity feeds to track file changes and trigger downstream actions.
* Query workspace documents with AI and summarize results.
* Build pipelines where new uploads start processing chains.

n8n has no dedicated nodes for Fastio. This guide covers the HTTP Request setups.

Helpful references: [Fastio Workspaces](/product/workspaces/), [Fastio Collaboration](/product/collaboration/), and [Fastio AI](/product/ai/).

## What to check before scaling Integrate Fastio API with n8n workflows

1. Create a Fastio account at Fastio (Business Trial offers multiple storage and multiple monthly credits).
2. Generate an API key: Log in, go to Settings > API Keys, create a new key.
3. Set up an n8n instance (cloud or self-hosted).
4. Know the n8n HTTP Request node and basic JSON handling.

### Create Your First Workspace

Use the API to create a workspace:
```
curl -H "Authorization: Bearer YOUR_API_KEY" \\
     https://api.fast.io/current/org/me/workspaces/ \\
     -d "folder_name=my-n8n-workspace" \\
     -d "name=n8n Integration Test"
```
Note the workspace ID from the response.

## Authenticate Fastio API in n8n

Fastio uses Bearer token authentication with API keys or JWTs.

**Recommended: API Key (long-lived)**
1. In n8n, add HTTP Request node.
2. Authentication: Header Auth.
3. Name: Authorization
4. Value: Bearer {{$node["Set API Key"].json["api_key"]}}

**Alternative: JWT via Basic Auth**
1. HTTP Request: GET `https://api.fast.io/current/user/auth/`
2. Authentication: Basic Auth (email/password).
3. Extract JWT from response: {{$json["auth_token"]}}
4. Use in subsequent nodes.

Store API key in n8n credentials for security.

## Configure HTTP Request Node for Fastio

Fastio API base URL: `https://api.fast.io/current/`

**Example: List Workspaces**
* Method: GET
* URL: `/org/me/workspaces/`
* Headers: Authorization (Bearer), Content-Type: application/x-www-form-urlencoded (for POST)
* Most endpoints use form-encoded bodies; comments use JSON.

**Node Setup:**
1. **Node Type:** HTTP Request
2. **URL:** `https://api.fast.io/current/{{endpoint}}` (e.g., `org/me/workspaces/`)
3. **Method:** GET/POST/PUT/DELETE per docs
4. **Authentication:** Header Auth > Name: `Authorization` > Value: `Bearer {{api_key}}`
5. **Send Headers:** Yes > Add `Content-Type: application/x-www-form-urlencoded`
6. **Send Body:** Yes (POST) > Body Content Type: Form-Data or Form-UrlEncoded
7. **Response Format:** JSON
8. **Ignore SSL Issues:** No (production)

Test with `GET /ping/` (no auth).

## Example Workflow: Upload File on Webhook Trigger

Build a workflow triggered by a form submission that uploads to Fastio.

1. **Webhook Trigger:** Listen for POST with file data.
2. **Set Node:** Prepare form data: `parent_id=root`, `name={{$json.file.name}}`
3. **HTTP Request (Start Upload):** POST `/upload/start/` with file details (size, content_type).
4. **Chunk Loop:** For large files, chunk and upload via `/upload/chunk/`.
5. **HTTP Request (Complete):** POST `/upload/complete/` to finalize.
6. **Respond to Webhook:** Return share link.

For small files (<multiple): Direct upload via `storage` endpoints.

### Handling Chunked Uploads

Fastio supports chunked uploads up to multiple. Use n8n Loop node for parallel chunks.

## Example Workflow: Poll Fastio Activity Events

Fastio provides an activity feed endpoint you can poll for file events (upload, modify, access).

1. **Schedule Trigger:** Poll Fastio at regular intervals.
2. **HTTP Request:** GET `/workspace/{id}/activity/` to fetch new events.
3. **Switch Node:** Route by event type (e.g., file uploaded).
4. **AI Chain:** Query new file with Fastio AI endpoint.
5. **Email Node:** Summarize and send.

Activity Endpoint: Call `/workspace/{id}/activity/` or listen to the WebSocket feed.

## Advanced: AI Queries and Ownership Transfer

**AI Document Query:**
POST `/workspaces/{id}/ai/chat/` with `type=chat_with_files`, `files_scope=nodeId:versionId`.

**Ownership Transfer:**
For agent-built workspaces, generate transfer token and email claim URL to human.

Monitor credits: GET `/org/me/billing/usage/limits/credits/`.

## Frequently asked questions

### Does Fastio integrate natively with n8n?

No native node, but full integration via HTTP Request node using Fastio's REST API and Bearer auth.

### How to use Fastio API in n8n HTTP node?

Set URL to `https://api.fast.io/current/{endpoint}`, Header Auth Bearer token, form-urlencoded body.

### How to trigger n8n workflows from Fastio events?

Use n8n Schedule trigger to poll Fastio workspace activity endpoints for events like file uploads.

### What plans does Fastio offer for API integrations?

Fastio offers Starter, Business, and Growth plans, alongside a 14-day Business Trial requiring a credit card.

## About Fast.io

Fast.io provides shared workspaces where people and AI agents work on the same files, with built-in semantic search and citation-backed chat over what they hold. Agents reach it through a remote MCP server at https://mcp.fast.io/mcp, a REST API at https://api.fast.io/current/, and a command line client published on npm as @vividengine/fastio-cli.