Reddit posting settings

Every post to Reddit carries a settings object with "__type": "reddit" and one entry for each subreddit the post goes to. Read the live schema for your channel with Get a channel’s settings.

Fields

Field	Type	Required	What it does
`__type`	string	No	Always `"reddit"`. PostQueen sets it from the channel you post to, so it can be left out.
`subreddit`	array	Yes	At least one entry. Each entry is `{ "value": { ... } }` with the fields below.

Each subreddit[].value takes:

Field	Type	Required	What it does
`subreddit`	string	Yes	The subreddit as a `/r/` path, such as `/r/homelab`.
`title`	string	Yes	The post title in that subreddit, 2 to 300 characters.
`type`	string	Yes	`self` for a text post, `link` for a link post, or `media` to post the first file attached to the post, one image or one MP4 video.
`url`	string	For `link`	The link of a link post. Must be a valid URL.
`is_flair_required`	boolean	Yes	Whether the subreddit demands flair. `true` makes `flair` required.
`flair`	object	When `is_flair_required` is `true`	One of the subreddit’s flairs, as `{ "id": "...", "name": "..." }`.

The post text, the content of the first entry in value, is the body in every subreddit. Only the title, type, link and flair change from one subreddit to the next. Reddit’s Responsible Builder Policy forbids automated posting of identical or substantially similar content across subreddits.

Finding subreddits and flairs

Two tools answer through trigger a provider tool. subreddits searches public subreddits by name, and also takes a pasted r/name link:

curl -X POST "https://api.postqueen.ai/public/v1/integration-trigger/YOUR_CHANNEL_ID" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "methodName": "subreddits", "data": { "word": "homelab" } }'

The response is { "output": [ { "title", "name", "id" } ] }, where name is the subreddit’s path. restrictions then tells you what one subreddit accepts:

curl -X POST "https://api.postqueen.ai/public/v1/integration-trigger/YOUR_CHANNEL_ID" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "methodName": "restrictions", "data": { "subreddit": "/r/homelab" } }'

The response is { "output": { "subreddit", "allow", "is_flair_required", "flairs": [ { "id", "name" } ] } }. allow lists the types the subreddit takes, from self, link and media. Copy is_flair_required into the entry, and pick one of flairs when it is true.

What PostQueen checks

A post that breaks one of these rules is refused with 400 before it is scheduled:

Rule	Message
A `media` entry needs exactly one file on the post	“When posting a media post, you must attached exactly one media file.”
Every MP4 on the post has a `thumbnail`	“You must attach a thumbnail to your video post.”
Body text up to 10,000 characters	“post is too long, please fix it”
At least one `subreddit` entry, each with `subreddit`, a `title` of 2 to 300 characters, a `type` from the list, a boolean `is_flair_required`, a `flair` when it is `true`, and a valid `url` on a `link`	A validation error naming the field

The error body names the channel and the rule:

{
  "statusCode": 400,
  "provider": "reddit",
  "name": "Your channel name",
  "message": "You must attach a thumbnail to your video post."
}

Each subreddit’s own rules are not checked first: allowed post types, karma, account age and posting rates. Subreddits are posted one at a time, and when Reddit refuses one the post fails with “Reddit rejected the post to r/name:” followed by Reddit’s reason.

Examples

Send each body to create a post. Replace YOUR_CHANNEL_ID with the channel’s id from list channels, each flair with one from the restrictions tool, and each media id and path with the values upload a file returns.

{
  "type": "schedule",
  "date": "2026-10-01T09:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "YOUR_CHANNEL_ID" },
      "value": [
        {
          "content": "I moved our photo backups from a cloud drive to a small home server last month. Here is what worked, what broke, and what it costs to run.",
          "image": []
        },
        {
          "content": "Happy to answer questions about the hardware in the replies.",
          "image": [],
          "delay": 10
        }
      ],
      "settings": {
        "__type": "reddit",
        "subreddit": [
          {
            "value": {
              "subreddit": "/r/homelab",
              "title": "One month of running our photo backups at home",
              "type": "self",
              "is_flair_required": false
            }
          }
        ]
      }
    }
  ]
}

{
  "type": "schedule",
  "date": "2026-10-01T09:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "YOUR_CHANNEL_ID" },
      "value": [
        {
          "content": "A write-up of how we cut our build times in half.",
          "image": []
        }
      ],
      "settings": {
        "__type": "reddit",
        "subreddit": [
          {
            "value": {
              "subreddit": "/r/devops",
              "title": "How we cut our CI build times in half",
              "type": "link",
              "url": "https://example.com/faster-builds",
              "is_flair_required": false
            }
          }
        ]
      }
    }
  ]
}

{
  "type": "schedule",
  "date": "2026-10-01T09:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "YOUR_CHANNEL_ID" },
      "value": [
        {
          "content": "Shot on a 50 mm lens at golden hour.",
          "image": [{ "id": "MEDIA_ID", "path": "https://uploads.postqueen.ai/harbor.jpg" }]
        }
      ],
      "settings": {
        "__type": "reddit",
        "subreddit": [
          {
            "value": {
              "subreddit": "/r/itookapicture",
              "title": "ITAP of the harbor at sunset",
              "type": "media",
              "is_flair_required": true,
              "flair": { "id": "FLAIR_ID", "name": "Landscape" }
            }
          }
        ]
      }
    }
  ]
}

{
  "type": "schedule",
  "date": "2026-10-01T09:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "YOUR_CHANNEL_ID" },
      "value": [
        {
          "content": "Timelapse of the build, start to finish.",
          "image": [
            {
              "id": "MEDIA_ID",
              "path": "https://uploads.postqueen.ai/build.mp4",
              "thumbnail": "https://uploads.postqueen.ai/build-thumbnail.jpg"
            }
          ]
        }
      ],
      "settings": {
        "__type": "reddit",
        "subreddit": [
          {
            "value": {
              "subreddit": "/r/somethingimade",
              "title": "I built a walnut desk in a weekend",
              "type": "media",
              "is_flair_required": false
            }
          }
        ]
      }
    }
  ]
}

In the first example, the second entry in value is a top-level comment, posted 10 minutes after the post. Comments on Reddit are text only, and they work on a post to one subreddit: on a post sent to several subreddits, the comments fail.

Get started

Endpoints

Posting settings by network

Build on PostQueen

SDK and no-code

Fields

Finding subreddits and flairs

What PostQueen checks

Examples

​Fields

​Finding subreddits and flairs

​What PostQueen checks

​Examples

​Related

Fields

Finding subreddits and flairs

What PostQueen checks

Examples

Related