Reddit API: Post to Any Subreddit

API id: reddit

On Reddit, each connected channel is a subreddit.

At a glance


Title	Required, up to 300 characters. Send it as `channels[].title`.
Text	10,000 characters
Files per post	Up to 20 images
File needed?	No
Extra blocks	Up to 5, published as comments under the post. Comments cannot have files.
Alt text	No
Edit after publish	Yes — the text
Delete after publish	Yes
Analytics	Likes, comments
Comments	Read and reply

Files

Images only: JPEG or PNG, up to 20 per post.

Options

Key	Type	What it does
`url`	url	Makes it a link post. Your text is still published as the body. A link post cannot have images.
`flair_id`	choice	The post flair. Many subreddits refuse posts without one.
`nsfw`	true / false	Mark as NSFW.
`spoiler`	true / false	Mark as a spoiler.
`original_content`	true / false	Mark as original content (OC). Only works where the subreddit allows OC tags.
`mute_replies`	true / false	Stop reply notifications from reaching the account's inbox.

Example: a link post

{
  "channelId": "CHANNEL_REDDIT",
  "title": "We open-sourced our scheduler",
  "options": { "url": "https://github.com/example/scheduler", "original_content": "true" },
  "blocks": [{ "content": "Happy to answer questions in the comments." }]
}

Good to know

Each subreddit has its own rules. A post that passes Bulkit's checks can still be removed by the subreddit's moderators.

Comments

You can read the comments on a published post and reply to them. See Read and reply to comments.

The newest 100 comments, two levels deep, in one page. There is no nextCursor, and branches Reddit collapses ("more replies") are not loaded.
likeCount is the comment's score (upvotes minus downvotes), like the post's own number.
Commenters show with their handle, for example u/name.
Your own extra blocks (the comments Bulkit posted for you) are not listed.
Needs the read and submit scopes. An account connected before read was added shows needs-reconnect. Reconnect it once.

Set up

To connect accounts, you first need your own app on this platform. See the Reddit app setup guide.

Reddit