n8n-nodes-substack

This n8n community node provides read-only access to the Substack API, enabling you to automate content discovery and analytics workflows with Substack publications.

n8n is a fair-code licensed workflow automation platform.

Features

• Profile Operations: Get profile information, followees, and publication data
• Post Operations: Retrieve posts with pagination support
• Note Operations: Access notes from publications and create new notes programmatically with optional title and body content, supporting both simple text and advanced JSON formatting
• Comment Operations: Get comments for posts
• Secure Authentication: API key authentication with publication address
• Powered by substack-api: Uses the robust substack-api library for reliable API interactions

Quick Start

Get Your Profile Information

{
  "nodes": [
    {
      "name": "Get My Profile",
      "type": "n8n-nodes-substack.substack",
      "parameters": {
        "resource": "profile",
        "operation": "getOwnProfile"
      },
      "credentials": {
        "substackApi": "your-credential-id"
      }
    }
  ]
}

Retrieve Recent Posts

{
  "nodes": [
    {
      "name": "Get Recent Posts",
      "type": "n8n-nodes-substack.substack",
      "parameters": {
        "resource": "post",
        "operation": "getAll",
        "limit": 10
      },
      "credentials": {
        "substackApi": "your-credential-id"
      }
    }
  ]
}

Installation

n8n Cloud

1. Go to Settings > Community Nodes
2. Click Install a community node
3. Enter n8n-nodes-substack
4. Click Install

Self-hosted n8n

Install the node in your n8n installation directory:

npm install n8n-nodes-substack

Then restart your n8n instance.

Credentials Setup

1. Add the Substack node to your workflow
2. Create new credentials with:
   • Publication Address: Your Substack domain (e.g., myblog.substack.com)
   • API Key: Your Substack API key

Documentation

📖 Complete Documentation - Comprehensive guides for all operations

• Resource Guides - Detailed documentation for Profile, Post, Note, and Comment operations
• Development Guide - Contributing to the project
• Testing Guide - Testing practices and procedures
• Architecture - Design decisions and project structure

License

MIT