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 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 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