Lemmy posting settings

Every post to Lemmy carries a settings object with "__type": "lemmy" and the communities to post in. Read the live schema for your channel with Get a channel’s settings. A Lemmy channel connects with your instance, username and password, which only the app’s connect form takes. Connect it in the app first, then post to it here.

Fields

Field	Type	Required	What it does
`__type`	string	No	Always `"lemmy"`. PostQueen sets it from the channel you post to, so it can be left out.
`subreddit`	array	Yes	The communities to post in, at least one. The name is historical: each entry is a Lemmy community on the channel’s instance.
`subreddit[].value.subreddit`	string	Yes	The community’s name as the `subreddits` tool returns it, at least 2 characters. PostQueen shows it in the app; Lemmy is sent the id.
`subreddit[].value.id`	string	Yes	The community’s numeric id, as a string.
`subreddit[].value.title`	string	Yes	The post’s title in this community, 3 to 200 characters.
`subreddit[].value.url`	string	No	A link to share with the post. Leave it out or send `""` for none.

Each community gets its own submission, with its own title and link and the same body from value[0].content, sent as plain text. The first file of the first entry becomes the cover image of every submission.

Find a community id

The subreddits tool searches the channel’s instance. Call it through trigger a provider tool:

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": "linux"}}'

It answers { "output": [{ "id": 1234, "name": "Linux", "title": "Linux" }] }. Send id as a string in value.id, and name in value.subreddit.

Follow-up comments

Each extra entry in value is posted as a top-level comment under the submission in every community, after its delay in minutes. Comments are text only.

What PostQueen checks

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

Rule	Message
At least one community	“subreddit must contain at least 1 elements”
A title of at least 3 characters	“title must be longer than or equal to 3 characters”
A title of at most 200 characters	“title must be shorter than or equal to 200 characters”
`url`, when set, is a web address	“url must be a URL address”
The first file is a PNG, JPG, JPEG, GIF or WebP image	“You can set only one picture for a cover”
Each entry within 10,000 characters	“post is too long, please fix it”

A settings field that is missing or wrong is refused first, with the field’s path in each message:

{
  "statusCode": 400,
  "message": ["posts.0.settings.subreddit.0.value.title must be longer than or equal to 3 characters"],
  "error": "Bad Request"
}

The other rules come back with the channel’s name:

{
  "statusCode": 400,
  "provider": "lemmy",
  "name": "Your channel name",
  "message": "You can set only one picture for a cover"
}

Each instance sets its own posting rate, and PostQueen does not check it first. Lemmy’s default is 6 posts in 10 minutes from one address.

Examples

Send each body to create a post. Replace YOUR_CHANNEL_ID with the channel’s id from list channels, each community id and name with the values the subreddits tool returns, 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": "We wrote up how we run our own mail server on a small VPS, with the full config.",
          "image": []
        }
      ],
      "settings": {
        "__type": "lemmy",
        "subreddit": [
          {
            "value": {
              "subreddit": "Linux",
              "id": "1234",
              "title": "Running your own mail server in 2026",
              "url": "https://example.com/mail-server"
            }
          }
        ]
      }
    }
  ]
}

{
  "type": "schedule",
  "date": "2026-10-01T09:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "YOUR_CHANNEL_ID" },
      "value": [
        {
          "content": "Our open data set of city bike trips is out, with a short write-up of what we found.",
          "image": [{ "id": "MEDIA_ID", "path": "https://uploads.postqueen.ai/bike-map.png" }]
        },
        { "content": "Questions welcome, we will answer here all day.", "image": [], "delay": 30 }
      ],
      "settings": {
        "__type": "lemmy",
        "subreddit": [
          { "value": { "subreddit": "Datasets", "id": "2345", "title": "City bike trips, one year of data" } },
          { "value": { "subreddit": "Cycling", "id": "3456", "title": "What a year of bike share trips shows" } }
        ]
      }
    }
  ]
}

Get started

Endpoints

Posting settings by network

Build on PostQueen

SDK and no-code

Fields

Find a community id

Follow-up comments

What PostQueen checks

Examples

​Fields

​Find a community id

​Follow-up comments

​What PostQueen checks

​Examples

​Related

Fields

Find a community id

Follow-up comments

What PostQueen checks

Examples

Related