Slack posting settings

Every post to Slack carries a settings object with "__type": "slack". Read the live schema for your channel with Get a channel’s settings.

Fields

Field	Type	Required	What it does
`__type`	string	No	Always `"slack"`. PostQueen sets it from the channel you post to, so it can be left out.
`channel`	string	Yes	The id of the Slack channel to post in, public or private. For a private channel, invite the app to it first.

One PostQueen channel is one Slack workspace. To post in two channels of the same workspace, send two posts. The text is sent as Slack mrkdwn, so *bold* and _italic_ work. Write a link as a plain URL, which Slack links by itself: text in angle brackets, such as Slack’s own link form, is read as HTML and comes out broken. Text longer than 3,000 characters is split into sections at line breaks, and each picture is shown under the text as an image block. Each extra entry in value is posted as a reply in the message’s thread, after its delay in minutes.

Find the channel id

The channels tool lists the workspace’s public channels and the private channels the app has been invited to. 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": "channels", "data": {} }'

The response is { "output": [ { "id", "name" } ] }. Put the chosen id, such as C0123456789, in settings.channel.

What PostQueen checks

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

Rule	Message
No video in any entry	“Slack posts can include pictures but not videos”
Each entry fits in 50 blocks: one per picture and one per 3,000 characters of text, so at most 150,000 characters	“A Slack message can hold at most 50 blocks: each picture is one, and the text takes one per 3,000 characters”
`channel` is set and not empty	A validation error naming the field, such as “posts.0.settings.channel should not be null or undefined”

The error body names the channel and the rule:

{
  "statusCode": 400,
  "provider": "slack",
  "name": "Your channel name",
  "message": "Slack posts can include pictures but not videos"
}

A missing or empty field fails the request validation instead, and the body lists every problem under message. Slack’s own rules are not checked first: an image block shows PNG, JPG and GIF only, and a private channel needs the app invited. If Slack refuses a message, the post fails with Slack’s reason, such as not_in_channel, instead of being marked published.

Examples

Send each body to create a post. Replace YOUR_CHANNEL_ID with the channel’s id from list channels, the Slack channel with an id from the channels 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": "*Release 2.4 ships today.* Faster exports and a new dark theme.",
          "image": []
        },
        {
          "content": "Release notes: https://example.com/changelog",
          "image": [],
          "delay": 5
        }
      ],
      "settings": { "__type": "slack", "channel": "SLACK_CHANNEL_ID" }
    }
  ]
}

{
  "type": "schedule",
  "date": "2026-10-01T09:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "YOUR_CHANNEL_ID" },
      "value": [
        {
          "content": "This week's numbers, in two charts.",
          "image": [
            { "id": "MEDIA_ID_1", "path": "https://uploads.postqueen.ai/signups.png" },
            { "id": "MEDIA_ID_2", "path": "https://uploads.postqueen.ai/revenue.png" }
          ]
        }
      ],
      "settings": { "__type": "slack", "channel": "SLACK_CHANNEL_ID" }
    }
  ]
}

In the first example, the second entry in value is posted 5 minutes after the message, as a reply in its thread.

Get started

Endpoints

Posting settings by network

Build on PostQueen

SDK and no-code

Fields

Find the channel id

What PostQueen checks

Examples

​Fields

​Find the channel id

​What PostQueen checks

​Examples

​Related

Fields

Find the channel id

What PostQueen checks

Examples

Related