Reddit settings
One Sharek post to Reddit can fan out to several subreddits inside the same channel.
The subreddit array holds one entry per subreddit, and each entry carries its own
title and type.
"settings": { "subreddit": [ { "value": { "...": "one subreddit's settings" } } ]}Note the nesting: subreddit is an array of objects that each wrap their real content
in a value key. At least one entry is required.
Fields inside each value
Section titled “Fields inside each value”| Field | Required | Description |
|---|---|---|
subreddit |
Yes | The subreddit, such as /r/example. The /r/ prefix is optional, so r/example and example work too. At least two characters. |
title |
Yes | The post title for this subreddit. At least two characters. |
type |
Yes | One of self (a normal text post), link (needs url) or media (the post’s first attached image or MP4 video). Any other value, including the older image, video and videogif, is refused. |
url |
Yes when type is link |
The link to submit. Must be a valid URL. |
is_flair_required |
Yes | Boolean. Whether this subreddit requires a flair. |
flair |
Yes when is_flair_required is true |
An object with id and name, both required. |
A text post
Section titled “A text post”"settings": { "subreddit": [ { "value": { "subreddit": "/r/example", "title": "What we learned shipping in public", "type": "self", "url": "", "is_flair_required": false } } ]}A link post with a flair
Section titled “A link post with a flair”"settings": { "subreddit": [ { "value": { "subreddit": "/r/example", "title": "Our launch post", "type": "link", "url": "https://example.com/launch", "is_flair_required": true, "flair": { "id": "flair-id", "name": "Discussion" } } } ]}A media post
Section titled “A media post”"value": [ { "content": "A quick tour of the new studio", "image": [ { "id": "media-id", "path": "https://media.example.com/tour.mp4", "thumbnail": "https://media.example.com/tour-cover.png" } ] }],"settings": { "subreddit": [ { "value": { "subreddit": "/r/example", "title": "A quick tour of the new studio", "type": "media", "url": "", "is_flair_required": false } } ]}The file comes from the post itself, not from settings: a media entry uploads the one
item in image on the first entry of the post’s value array (see
create a post), and every media entry in subreddit uses that same
file. Two rules apply when the post is created:
- With any
mediaentry, that first entry must carry exactly one item inimage. Otherwise the post is refused withWhen posting a media post, you must attached exactly one media file. - Every MP4 attached to a Reddit post needs a
thumbnail: the address of an uploaded cover image. Without one the post is refused withYou must attach a thumbnail to your video post.
Two subreddits in one post
Section titled “Two subreddits in one post”"settings": { "subreddit": [ { "value": { "subreddit": "/r/example", "title": "Title for the first subreddit", "type": "self", "url": "", "is_flair_required": false } }, { "value": { "subreddit": "/r/another", "title": "A different title for this one", "type": "self", "url": "", "is_flair_required": false } } ]}Finding subreddits and flairs
Section titled “Finding subreddits and flairs”Subreddit names and flair ids are looked up per channel rather than guessed. Call trigger a channel tool with the tool name that channel settings reports for the Reddit channel.