UltimateReddit icon

UltimateReddit

Consume the Reddit API

Actions13

Overview

The node "UltimateReddit" enables creating posts on Reddit within specified subreddits. It supports multiple post types including text posts, link posts, image posts, and uploads of images or videos. This node is useful for automating content publishing workflows to Reddit, such as scheduling posts, cross-posting content from other platforms, or managing subreddit engagement programmatically.

Practical examples:

  • Automatically create a text post with markdown formatting in a subreddit.
  • Share a link post with a URL and optional flair.
  • Upload an image or video directly from binary data stored in n8n.
  • Control reposting behavior to avoid duplicate submissions unless explicitly allowed.

Properties

Name Meaning
Subreddit The target subreddit where the post will be created.
Kind The type of post to create. Options: Text Post, Link Post, Image Post, Upload Image/Video Post.
Title The title of the post, up to 300 characters long.
NSFW Boolean flag indicating if the post is Not Safe For Work (adult content).
Flair ID Optional flair template ID to tag the post with a specific flair.
Flair Text Optional flair text to display on the post.
URL The URL to include in the post (required for Link and Image posts).
Text The main text content of the post (required for Text posts). Supports Markdown formatting.
Text (optional) Optional text content for Link, Image, or Upload posts. Supports Markdown formatting.
Resubmit Boolean flag to allow reposting the same URL even if it was posted before; otherwise reposting errors out.
Video Binary Data The name of the input binary property containing video data (required for Upload posts).
Thumbnail Binary Data The name of the input binary property containing thumbnail image data (required for Upload posts).

Output

The node outputs JSON data representing the response from Reddit's API after creating the post. This typically includes details about the newly created post such as its ID, URL, title, and other metadata returned by Reddit.

If the post involves uploading media (image/video), the node handles binary data inputs but does not output binary data itself; the output remains JSON describing the created post.

Dependencies

  • Requires valid Reddit API credentials with appropriate permissions to create posts.
  • The node optionally uses OAuth2 authentication for Reddit API access.
  • For media uploads, the node expects binary data to be provided in the workflow input under specified property names.

Troubleshooting

  • Error: Duplicate URL submission — Occurs when trying to post a URL that has already been submitted to the subreddit without enabling the "Resubmit" option. Enable "Resubmit" to override this.
  • Missing required fields — Ensure all required properties for the selected post kind are provided, e.g., "URL" for link/image posts, "Text" for text posts, and binary data for upload posts.
  • Authentication errors — Verify that the Reddit API credentials are correctly configured and have necessary scopes.
  • Invalid flair ID or text — Using incorrect flair identifiers may cause the post creation to fail; verify flair templates exist in the subreddit.
  • Binary data issues — For upload posts, ensure the binary data properties exist and contain valid media files.

Links and References

Discussion