n8n-nodes-substack-new

n8n community package that integrates Substack Gateway OSS
with n8n workflows. Provides full read and write access to Substack — notes,
drafts, posts, profiles, and feed triggers — through a self-hosted gateway
backend.

[!IMPORTANT]
This is an unofficial community node. It is not part of n8n and is not
compatible with n8n Cloud. To use this package you need a self-hosted n8n
instance and a running Substack Gateway.

Installation

Install the package in the n8n instance where community nodes are enabled:

npm install n8n-nodes-substack-new

Restart n8n after installation.

Nodes

• Substack Gateway
  Main action node for gateway-backed Substack reads and writes across own publication, notes, drafts, posts, and profiles.
• Substack Gateway Following Feed
  Polling trigger for the authenticated user's following feed.
• Substack Gateway Profile Feed
  Polling trigger for a specific Substack profile feed.
• Substack Gateway Batch Feed
  Polling trigger for an Atom feed aggregated across an explicit comma-separated list of profile handles. Registers the list on the gateway via an idempotent PUT and polls the returned UUID.
• Randomizer
  Trigger node that emits events at random times inside configured schedule windows.

Credentials

The Substack nodes use the Substack Gateway credential with:

• Gateway URL
• Gateway Token

Gateway Compatibility

Different Substack Gateway deployments may expose different features and operations.

• some gateways may support only a subset of the documented actions
• available resources and operations can vary between gateway instances
• feed triggers and reaction actions such as Like / Unlike may depend on gateway-specific capability support

If an operation does not appear in the node editor or fails with a gateway support error, check the capabilities of the specific Substack Gateway you configured.

Resources

Current resources and operations:

• Own Publication
  • Own Profile
  • Own Notes
  • Own Posts
  • Own Following
• Note
  • Create
  • Get
  • Delete
  • Like
  • Unlike
• Draft
  • Create
  • Get
  • Get Many
  • Update
  • Delete
• Post
  • Get
  • Get Comments
  • Like
  • Unlike
• Profile
  • Get
  • Get Notes
  • Get Posts

Restack operations are not currently exposed by the package.

Quickstart

1. Install the package and restart n8n.
2. Create a Substack Gateway credential for the Substack nodes.
3. Add one of the package nodes to a workflow.
4. For the main action node, try:
   • Resource: Own Publication
   • Operation: Own Profile

For a simple write flow, use Substack Gateway with:

• Resource: Note
• Operation: Create
• Content: ...
• Attachment: ... (optional)

For feed polling, use:

• Substack Gateway Following Feed to watch your authenticated following feed
• Substack Gateway Profile Feed to watch a specific profile's Atom feed
• Substack Gateway Batch Feed to watch a combined Atom feed for a curated, comma-separated list of profile handles

For schedule-based triggering, use:

• Randomizer with one or more windows and a target timezone

Development

Common commands:

pnpm run build
pnpm run dev
pnpm run lint
pnpm test
pnpm test:unit
pnpm run test:package

Notes:

• pnpm run build uses tsup and copies the n8n static assets into dist/
• pnpm run dev builds the package, prepares a local dev package, and runs local n8n with watch mode
• pnpm test runs the Cucumber feature suite
• pnpm test:unit runs the fast source-level TypeScript tests
• pnpm run test:package verifies the built dist/ package

Documentation

• Docs Index
• Quickstart
• n8n Usage
• Architecture
• Testing

Compatibility

This package targets modern n8n releases with community nodes enabled. Verify against the current build and test workflow in this repository.

Author

Built by Jakub Slys — Backend Engineer and n8n
self-hoster who uses this node package as part of his own content automation
pipeline running on a self-hosted Kubernetes cluster.

These nodes connect to Substack Gateway OSS,
a Python REST + MCP backend I built to automate my Substack newsletter at
iam.slys.dev.

I write about building exactly this kind of stack — n8n workflows, self-hosted
AI tooling, and the engineering decisions behind them.

→ iam.slys.dev