What every request needs
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.
type, date, shortLink, tags and posts are all required, and each entry in value needs image, even when it is empty:
settings object: see Posting settings by network. Schedule a post walks through the whole flow, media included.
Zapier
1
Add the action
Add a Webhooks by Zapier action and choose the Custom Request event. The plain POST event cannot send the nested JSON a post needs.
2
Fill in the request
Set Method to
POST, URL to https://api.postqueen.ai/public/v1/posts, and Data to the JSON body. Under Headers, add Authorization with your API key and Content-Type with application/json.3
Test the step
A working request answers with
[{ "postId": "...", "integration": "..." }], and the post appears on your calendar.Webhooks by Zapier is on Zapier’s Professional, Team and Enterprise plans, not the Free plan.
Make
1
Add the module
Add the HTTP app and choose Make a request.
2
Fill in the request
Set URL to
https://api.postqueen.ai/public/v1/posts and Method to POST. Under Headers, add Authorization with your API key. Set Body content type to application/json, Body input method to JSON string, and paste the body into Body content.3
Parse the answer
Set Parse response to Yes, so the returned
postId can be mapped into later modules. Run the module once to check it.The other direction
To start a Zap or a scenario when PostQueen publishes a post, add a PostQueen webhook that points at Zapier’s Catch Hook trigger or Make’s Custom webhook module.Limits
A workspace can send 30 requests to create posts in an hour, and a request PostQueen refuses counts too. A Zap or scenario that loops over many rows can reach it, so put several channels in one request where you can. The limits and the error codes are on Limits and errors.Next steps
Schedule a post with the API
From listing your channels to checking that the post went out.
Posting settings by network
The settings each network needs in a post, and which fields are required.
Limits and errors
The hourly limits, and the status codes the API returns.
Node.js SDK
Call the API from JavaScript or TypeScript with @postqueen/node.