Posting settings by network

Every post you send to create a post names a channel and carries a settings object for that channel’s network. This page lists, for each network, the settings type, the fields a post must include and the text limit. Each network’s page has every field, the rules PostQueen checks and complete examples.

How settings work

__type follows the channel. PostQueen sets settings.__type from the channel in integration.id, whatever you send. Send it anyway: it keeps the body readable and matches the tables below.
Settings are checked before anything is saved. The settings fields are checked on every post, drafts included, and the network’s own rules, such as media counts and the text limit, on every post but a draft. A body that fails is refused with 400 and nothing is saved.
Read the live schema. Integration settings returns a channel’s settings schema, its text limit and its tools.
Fetch the values you cannot know. Board, list, publication and category ids come from the network through provider tools, called with trigger a provider tool.
Extra entries in value are follow-ups. On networks that take them, each entry after the first is a reply or comment, published after its delay in minutes. On networks that take none, only the first entry is published.

Two error shapes

A missing or wrong settings field is refused first, as a list with each field’s path:

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

A post that breaks one of the network’s own rules, such as a media count or the text limit, names the channel instead:

{
  "statusCode": 400,
  "provider": "bluesky",
  "name": "Your channel name",
  "message": "There can be maximum 4 pictures in a post."
}

Status and connecting

A post needs a connected channel, and not every network can be connected today:

Status	What it means for the API
	Connect the channel in the app, then post to it here.
	The channel connects and posts within the limit its page states, until that limit is lifted.
	The channel cannot be connected on PostQueen yet, so there is nothing to post to. Its page documents the settings it will take.

All eight available networks connect with a key, a password or an agent that only the app’s connect form takes, so Get a connect URL cannot connect them. Connect them in the app, then read their ids with list channels.

Network	`__type`	A post must include	Text limit
Instagram	`instagram`, `instagram-standalone`	`post_type`	2,200 characters
TikTok	`tiktok`, `tiktok-business`	`content_posting_method`, `privacy_level`, and six interaction and disclosure fields	2,000 characters
Facebook	`facebook`	Nothing more	63,206 characters
X	`x`	`who_can_reply_post`, except on an Article	280 characters, 4,000 on verified accounts
LinkedIn	`linkedin`, `linkedin-page`	Nothing more	3,000 characters
Threads	`threads`	Nothing more	500 bytes
Bluesky	`bluesky`	Nothing more	300 characters
Reddit	`reddit`	`subreddit`, each with a subreddit, `title`, `type` and `is_flair_required`	10,000 characters
Mastodon	`mastodon`	Nothing more	500 characters
Tumblr	`tumblr`	Nothing more	32,768 characters
VK	`vk`	Nothing more	2,048 characters
Farcaster	`wrapcast`	Nothing more	1,024 bytes
Nostr	`nostr`	Nothing more	100,000 characters
Lemmy	`lemmy`	`subreddit`, each with a community name, `id` and `title`	10,000 characters
MeWe	`mewe`	`postType`, and `group` for a group post	63,206 characters

Video and live

Network	`__type`	A post must include	Text limit
YouTube	`youtube`	`title`, `type`	5,000 bytes
Twitch	`twitch`	Nothing more	500 characters
Kick	`kick`	Nothing more	500 characters

Business and discovery

Network	`__type`	A post must include	Text limit
Pinterest	`pinterest`	`board`	800 characters
Google Business Profile	`gmb`	Nothing more for an update; an event or offer needs its title and dates	1,500 characters
Dribbble	`dribbble`	`title`	40,000 characters

Chat and communities

Network	`__type`	A post must include	Text limit
Telegram	`telegram`	Nothing more	4,096 characters, 1,024 with media
Discord	`discord`	`channel`	1,980 characters
Slack	`slack`	`channel`	150,000 characters
Skool	`skool`	`group`, `label`, `title`	5,000 characters
Whop	`whop`	`company`, `experience`	50,000 characters
Moltbook	`moltbook`	`submolt`	300 characters

Blogs and newsletters

Network	`__type`	A post must include	Text limit
WordPress	`wordpress`	`title`, `type`	100,000 characters
DEV	`devto`	`title`	100,000 characters
Hashnode	`hashnode`	`title`, `publication`, `tags`. Needs Hashnode Pro on the publication	10,000 characters
Listmonk	`listmonk`	`subject`, `preview`, `list`	300,000 characters in the app

For Moltbook, Get a channel’s settings answers “No additional settings required”, but a post needs submolt. Moltbook posting settings has the details.

Next steps

Schedule a post with the API

From listing your channels to checking that the post went out.

Create a post

The full request body, the post types and the responses.

Limits and errors

The hourly limits, and the status codes the API returns.

Channels and their status

What each network posts and whether you can connect it today.

Get started

Endpoints