Listmonk posting settings

Every post to Listmonk carries a settings object with "__type": "listmonk", a subject, preview text and a list. At the scheduled time PostQueen creates a campaign on your Listmonk server and starts sending it. Read the live schema for your channel with Get a channel’s settings. A Listmonk channel connects with your server’s address, an API user and its token, 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 `"listmonk"`. PostQueen sets it from the channel you post to, so it can be left out.
`subject`	string	Yes	The email subject, at least 1 character. The campaign is named after it.
`preview`	string	Yes	The preview text inboxes show next to the subject, added as hidden text at the top of the email. Send `""` for none.
`list`	string	Yes	The id of the one list that receives the campaign, from the `list` tool, as a string.
`template`	string	No	The id of a template from the `templates` tool, as a string. Leave it out, or send `"0"`, for Listmonk’s default template.

The body comes from value[0].content and is sent as an HTML campaign. To show a picture in the email, put <img src="..." alt="..."> in the content where it should appear, with the path of a picture in your media library; a src that is not a PostQueen upload is dropped. Media in value[].image is not sent, and Listmonk has no follow-ups, so entries after the first in value are not published.

Find lists and templates

Two tools read them from your server. Call them through trigger a provider tool, with no data:

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": "list", "data": {}}'

Tool	Answers	Use it for
`list`	`[{ "id": 3, "name": "Newsletter" }, ...]`	`list`: send the `id` as a string
`templates`	`[{ "id": 0, "name": "Default" }, { "id": 4, "name": "..." }, ...]`	`template`: send the `id` as a string

Each answer comes wrapped in { "output": ... }.

What PostQueen checks

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

Rule	Message
A subject of at least 1 character	“subject must be longer than or equal to 1 characters”
`preview` is a string, empty or not	“preview must be a string”
`list` is a string	“list must be a string”
The body within 100,000,000 characters	“post is too long, please fix it”

The settings rules come back as a list, with each field’s path:

{
  "statusCode": 400,
  "message": ["posts.0.settings.list must be a string"],
  "error": "Bad Request"
}

The text limit comes back with the channel’s name instead, as on posting settings by network. The app’s editor stops sooner, at 300,000 characters. A list id that your server does not have is not checked first: Listmonk refuses the campaign when it is created.

Examples

Send each body to create a post. Replace YOUR_CHANNEL_ID with the channel’s id from list channels, and the list and template ids with values from the tools above.

{
  "type": "schedule",
  "date": "2026-10-01T09:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "YOUR_CHANNEL_ID" },
      "value": [
        {
          "content": "<h2>October at a glance</h2><p>Three new features, one event and a small price change. Read on for the details.</p>",
          "image": []
        }
      ],
      "settings": {
        "__type": "listmonk",
        "subject": "October news: three new features",
        "preview": "Plus the date of our next meetup",
        "list": "3"
      }
    }
  ]
}

{
  "type": "schedule",
  "date": "2026-10-01T09:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "YOUR_CHANNEL_ID" },
      "value": [
        { "content": "<p>Your weekly digest is here.</p>", "image": [] }
      ],
      "settings": {
        "__type": "listmonk",
        "subject": "Weekly digest",
        "preview": "",
        "list": "3",
        "template": "4"
      }
    }
  ]
}

Get started

Endpoints

Posting settings by network

Build on PostQueen

SDK and no-code

Fields

Find lists and templates

What PostQueen checks

Examples

​Fields

​Find lists and templates

​What PostQueen checks

​Examples

​Related

Fields

Find lists and templates

What PostQueen checks

Examples

Related