Schedule a post with the API

This walks through one post from start to finish: an image post to Bluesky, scheduled for a set time, then checked. It takes six calls. Bluesky needs no settings, so the post body stays short; the WordPress notes show what changes for a network that does. You need an API key and at least one connected channel. To connect one, see Connect a channel.

Where the API key is: in the app, open Connections > API Keys. Only a workspace Admin or Super Admin can reveal or rotate it; other members see it masked. A workspace has one key, and each agent card on Connections shows your MCP address with the key already filled in.

1. Check the key

curl "https://api.postqueen.ai/public/v1/is-connected" \
  -H "Authorization: YOUR_API_KEY"

{ "connected": true } means the key works. A 401 says why it does not: see Limits and errors.

2. Find the channel

curl "https://api.postqueen.ai/public/v1/integrations" \
  -H "Authorization: YOUR_API_KEY"

[
  {
    "id": "cmg1ozx2c0000qz0h8c7w5v3n",
    "name": "PostQueen",
    "identifier": "bluesky",
    "disabled": false,
    "profile": "postqueen.bsky.social",
    "picture": "https://cdn.example.com/avatar.png"
  }
]

Keep the id of the channel you want. It is YOUR_CHANNEL_ID below.

3. Read what the network needs

curl "https://api.postqueen.ai/public/v1/integration-settings/YOUR_CHANNEL_ID" \
  -H "Authorization: YOUR_API_KEY"

{
  "output": {
    "rules": "Bluesky can have maximum 1 video or 4 pictures in one post, it can also be without attachments",
    "maxLength": 300,
    "settings": "No additional settings required",
    "tools": []
  }
}

Bluesky takes up to 300 characters, up to four pictures or one video, and no settings.

For WordPress: fill the settings with a tool

A WordPress channel answers with a settings schema that requires title and type. type is a post type such as posts, and the postTypes tool lists them:

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

{ "output": [{ "id": "posts", "name": "Posts" }, { "id": "pages", "name": "Pages" }] }

The post then carries "settings": { "title": "...", "type": "posts" }. Every network’s settings: Posting settings by network.

4. Upload the image

curl -X POST "https://api.postqueen.ai/public/v1/upload" \
  -H "Authorization: YOUR_API_KEY" \
  -F "file=@launch-banner.png"

{
  "id": "e639003b-f727-4a1e-87bd-74a2c48ae41e",
  "name": "a1b2c3d4e5.png",
  "originalName": "launch-banner.png",
  "path": "https://cdn.example.com/a1b2c3d4e5.png",
  "thumbnail": null,
  "alt": null,
  "status": "ready"
}

Keep id and path. An image is ready at once. A video comes back processing: call Get media status every few seconds until it is ready, and use the path from that answer.

5. Create the post

Pick a time in UTC that is still ahead: with schedule, a time that has already passed publishes the post at once. To use the channel’s next free posting time instead, Find a free slot returns one.

curl -X POST "https://api.postqueen.ai/public/v1/posts" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "schedule",
    "date": "2026-10-01T09:00:00.000Z",
    "shortLink": false,
    "tags": [],
    "posts": [
      {
        "integration": { "id": "YOUR_CHANNEL_ID" },
        "value": [
          {
            "content": "The new calendar is live.",
            "image": [
              { "id": "e639003b-f727-4a1e-87bd-74a2c48ae41e", "path": "https://cdn.example.com/a1b2c3d4e5.png" }
            ]
          }
        ]
      }
    ]
  }'

const res = await fetch("https://api.postqueen.ai/public/v1/posts", {
  method: "POST",
  headers: {
    Authorization: process.env.POSTQUEEN_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    type: "schedule",
    date: "2026-10-01T09:00:00.000Z",
    shortLink: false,
    tags: [],
    posts: [
      {
        integration: { id: "YOUR_CHANNEL_ID" },
        value: [
          {
            content: "The new calendar is live.",
            image: [{ id: "e639003b-f727-4a1e-87bd-74a2c48ae41e", path: "https://cdn.example.com/a1b2c3d4e5.png" }],
          },
        ],
      },
    ],
  }),
});
if (res.status !== 201) throw new Error(JSON.stringify(await res.json()));
const [{ postId }] = await res.json();

The answer is 201 with the new post’s id:

[{ "postId": "cmg1p0s7k0001qz0h4yq2a8r1", "integration": "cmg1ozx2c0000qz0h8c7w5v3n" }]

A 400 means nothing was saved, and the body says what to fix. For example, text over 300 characters on Bluesky answers post is too long, please fix it.

To post the same thing on several channels, add one entry per channel to posts. To add a thread, add more items to value, each with "image": [] if it has no media and an optional delay in minutes. It is still one request.

6. Check that it went out

List the posts of that day:

curl "https://api.postqueen.ai/public/v1/posts?startDate=2026-10-01T00:00:00.000Z&endDate=2026-10-01T23:59:59.000Z" \
  -H "Authorization: YOUR_API_KEY"

Find your postId and read its state:

`state`	What it means
`QUEUE`	Scheduled, not published yet
`PUBLISHED`	Live. `releaseURL` links to it on the network
`ERROR`	Publishing failed. `error` has the network’s reason
`DRAFT`	A draft. It keeps its date, and nothing publishes it

PUBLISHED with a releaseURL means the post is live on Bluesky.

To be told the moment a post goes out instead of asking, add a webhook.

Change or cancel it

To	Call
Hold it back without deleting it	Change post status to `draft`
Change its network settings	Update post settings
Change the text or the time	Create a post again with `value[].id` set to the post’s id
Remove it	Delete a post

Next steps

Create a post

Every field of the request, the post types and the settings each network requires.

Posting settings by network

The settings of each network, with examples.

Limits and errors

The hourly limits, and what each status code means.

Node.js SDK

The same calls from JavaScript or TypeScript.

Get started

Endpoints

Posting settings by network

Build on PostQueen

SDK and no-code

Schedule a post with the API

1. Check the key

2. Find the channel

3. Read what the network needs

4. Upload the image

5. Create the post

6. Check that it went out

Change or cancel it

Next steps

Create a post

Posting settings by network

Limits and errors

Node.js SDK

​1. Check the key

​2. Find the channel

​3. Read what the network needs

​4. Upload the image

​5. Create the post

​6. Check that it went out

​Change or cancel it

​Next steps

Create a post

Posting settings by network

Limits and errors

Node.js SDK

1. Check the key

2. Find the channel

3. Read what the network needs

4. Upload the image

5. Create the post

6. Check that it went out

Change or cancel it

Next steps