Skip to content

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.

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.
"settings": {
"subreddit": [
{
"value": {
"subreddit": "/r/example",
"title": "What we learned shipping in public",
"type": "self",
"url": "",
"is_flair_required": false
}
}
]
}
"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" }
}
}
]
}
"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 media entry, that first entry must carry exactly one item in image. Otherwise the post is refused with When 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 with You must attach a thumbnail to your video 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
}
}
]
}

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.