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": "john@example.com",
  "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": "john@example.com"
}

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