n8n-nodes-flodesk

This is an n8n community node for Flodesk, an email marketing platform designed for small businesses and creators.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

npm install n8n-nodes-flodesk

Credentials

API Key Authentication

1. Log in to your Flodesk account
2. Go to Settings → Integrations → API
3. Create a new API key
4. Copy the API key and use it in n8n

OAuth2 Authentication

For partner integrations, use OAuth2:

• Authorization URL: https://api.flodesk.com/oauth2/authorize
• Token URL: https://api.flodesk.com/oauth2/token
• Scope: all

Nodes

Flodesk Node

The main node for interacting with the Flodesk API.

Resources

| Resource | Operations | |----------|------------| | Subscriber | Create/Update, Get, Get Many, Add to Segments, Remove from Segments, Unsubscribe | | Segment | Create, Get, Get Many, Get Colors | | Workflow | Get Many, Add Subscriber, Remove Subscriber | | Custom Field | Create, Get Many | | Webhook | Create, Get, Get Many, Update, Delete |

Flodesk Trigger Node

A webhook trigger node that listens for Flodesk events:

• Subscriber Created - Triggers when a new subscriber is added
• Subscriber Added to Segment - Triggers when a subscriber joins a segment
• Subscriber Unsubscribed - Triggers when a subscriber opts out

Usage Examples

Add a subscriber to Flodesk

{
  "resource": "subscriber",
  "operation": "upsert",
  "email": "[email protected]",
  "additionalFields": {
    "first_name": "John",
    "last_name": "Doe",
    "segment_ids": "seg_123,seg_456"
  }
}

Get all subscribers in a segment

{
  "resource": "subscriber",
  "operation": "getAll",
  "filters": {
    "segment_id": "seg_123",
    "status": "active"
  }
}

Add subscriber to a workflow

{
  "resource": "workflow",
  "operation": "addSubscriber",
  "workflowId": "wf_123",
  "subscriberId": "[email protected]"
}

API Rate Limits

Flodesk allows up to 100 requests per minute. If exceeded, the API returns a 429 error with rate limit headers:

• X-Fd-RateLimit-Limit: Maximum requests per minute
• X-Fd-RateLimit-Remaining: Remaining requests

Development

# Install dependencies
pnpm install

# Build the node
pnpm build

# Run in development mode with hot reload
pnpm dev

# Lint code
pnpm lint

Compatibility

• Node.js v22 or higher
• n8n v1.0 or higher

Resources

• Flodesk API Documentation
• n8n Community Nodes Documentation

License

MIT