Submit Post
reddit.submit_post
ActionChat & messagingconnection required
Calls the Reddit API with the connection's credentials.
Submit a text (self) post or a link post to a subreddit.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- OAuth 2.0
- Providers
- Secret shape
- {"client_id": "…", "client_secret": "…", "refresh_token": "…"}
- Config it needs
- user_agent, subreddit
- Resolved by
- config.connection_id, else node.connection_id
Configuration
11 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
subreddit Subreddit to act on, with or without the 'r/' prefix. Falls back to the connection's default subreddit when left blank. | string | No | — | — | python |
title Title of the post, as it appears in the subreddit. | string | Yes | — | ≤ 300 characters | — |
kind Whether this is a text post ('self') or a link post ('link'). | string | No | self | one of "self", "link" | — |
text Markdown body of a text post; optional extra body text on a link post. | string | No | — | — | — |
url Link a 'link' post points at. Required when kind is 'link'. | string | No | — | — | — |
flair_id Id of a flair template the subreddit offers for posts. | string | No | — | — | — |
flair_text Flair text, where the chosen flair template allows editing it. | string | No | — | — | — |
nsfw Mark the post as not safe for work. | boolean | No | false | — | — |
spoiler Mark the post as a spoiler. | boolean | No | false | — | — |
send_replies Send replies to this post to the author's inbox. | boolean | No | true | — | — |
resubmit Allow a link already submitted to this subreddit to be posted again. | boolean | No | false | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"kind": "self",
"nsfw": false,
"resubmit": false,
"send_replies": true,
"spoiler": false,
"subreddit": "python"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
id Id of the new post, without its 't3_' prefix. | string | — |
name Fullname of the new post, such as 't3_abc123'. | string | — |
url Permalink Reddit assigned to the new post. | string | — |
errors Reddit's api_type=json error rows, each with a code, message and field. Empty when Reddit accepted the write without complaint. | array | — |
{
"errors": [],
"id": "",
"name": "",
"url": ""
}Notes
- Image, video and gallery posts need a media upload this endpoint does not accept, so only text and link posts are supported.
See Submit Post run in a workflow.
In a technical demo we add the Reddit connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.