OpenQuok Bluesky Posting API
Publish Bluesky posts with text, images, video, link cards, and follow-up replies through POST /public/posts.
Built for people who connect their own channels
Who publishes to, Bluesky via API?
Vibe coders
Connect your own social accounts in OpenQuok Cloud. Complete OAuth for each channel yourself. Then publish with curl, the Node SDK, MCP, or CLI. Draft JSON in the payload validator. Publish to Bluesky through the same request shape.
CLI and SDK users
Call POST /public/posts from a script or CI job. One opo_ token covers every channel you connected. Your plan still caps channels and posts per month. Publish to Bluesky through the same request shape.
Agent operators
Point Cursor, Claude Code, or another MCP host at your workspace. The agent posts only to accounts you already authorized. Publish to Bluesky through the same request shape.
Federated & custom-PDS users
Stay on bsky.social or run your own PDS. OpenQuok resolves your service URL at connect and schedules through your home server with an app password — not your main account password. Publish to Bluesky through the same request shape.
Three steps
Add Bluesky posting,to your product in three steps
Connect Bluesky once, then publish and track delivery through the same API.
New to OpenQuok? Read the getting started guide
Free payload wizard
Test your social media posting API payload before you ship code
Compose a post with sample channels in your browser. Copy the JSON body and paste it into curl, your SDK, or an agent workflow. Copy JSON is free — no account required. Scheduling and file uploads need a workspace.
Sample channels
Sample channels
Endpoint
POST /api/v1/public/posts
{
"scheduledAt": "2026-01-01T12:00:00.000Z",
"status": "scheduled",
"body": "Hello from Bluesky — text-only post.",
"integrationIds": [
"<integration-id>"
]
}Explore request and response examples by format
Static examples mirror shipped OpenQuok public API payloads and success responses.
Publish a text post to Bluesky with POST /public/posts.
Request
{
"scheduledAt": "2026-01-01T12:00:00.000Z",
"status": "scheduled",
"body": "Hello from Bluesky — text-only post.",
"integrationIds": [
"<integration-id>"
]
}Response
{
"success": true,
"data": {
"postGroup": "9a0a1b2c-3d4e-4f5a-9b8c-aa11bb22cc33",
"posts": [
{
"id": "5b3c1d2e-9a3f-4e6b-bb12-2c0a5f1a90a1",
"state": "QUEUE",
"publishDate": "2026-01-01T12:00:00.000Z",
"organizationId": "c1d8a3f4-1234-4abc-bf12-1234567890ab",
"integrationId": "1f9a4f3a-3b2c-4f4a-9d8e-7a3f6b1c8e22",
"content": "Hello from Bluesky — text-only post.",
"delay": 0,
"postGroup": "9a0a1b2c-3d4e-4f5a-9b8c-aa11bb22cc33",
"title": null,
"description": null,
"parentPostId": null,
"releaseId": null,
"releaseUrl": null,
"settings": null,
"image": null,
"intervalInDays": null,
"error": null,
"deletedAt": null,
"createdByUserId": null,
"createdAt": "2026-05-10T09:00:00.000Z",
"updatedAt": "2026-05-10T09:00:00.000Z"
}
]
}
}More social media posting API platforms
Compare Bluesky with other networks, or jump to platform docs and provider settings.
-
TikTok
Vertical video and photo carousels. Direct publish or queue to your TikTok inbox so you can add trending audio.
-
X
Weighted 280-character tweets (4000 for Verified). Up to four images or one video. Scheduled thread replies.
-
Instagram
Feed posts, Reels, carousels, and Stories. Trial Reels, collaborator tags, and follow-up comments.
-
YouTube
Long-form MP4 uploads and vertical Shorts. Title, privacy, tags, and custom thumbnail per video.
-
Facebook
Page feed posts, MP4 Reels, Stories, link-preview cards, and scheduled follow-up comments. Built for Facebook Pages, not personal profiles.
-
Threads
500-character posts with media and scheduled follow-up reply chains. Conversation-first text on Meta Threads.
-
LinkedIn
B2B thought leadership on profile and company Page. Scheduled and reviewed. Ready when buyers research you.
- Open Bluesky channel page
Node SDK
TypeScript SDKfor Node.js backendstyped REST calls
Install @openquok/node-sdk in your Next.js or TypeScript backend. Call post() to publish to Bluesky with the same JSON you send to POST /public/posts. Media, integrations, and provider settings stay typed.
npm install @openquok/node-sdk
import Openquok from '@openquok/node-sdk';
const openquok = new Openquok('opo_your_programmatic_token');
await openquok.post({
{
"scheduledAt": "2026-01-01T12:00:00.000Z",
"status": "scheduled",
"body": "Hello from Bluesky — text-only post.",
"integrationIds": [
"<integration-id>"
]
}
});# After you add OpenQuok in your MCP client config:
# Ask your agent to publish to Bluesky.
> Publish to Bluesky now:
> Product launch recap with a link to our pricing page.MCP server
MCP toolsfor Cursor and Claude Codesame public API
Connect your MCP client with an opo_ token. Publish Bluesky posts from chat with schedulePostTool and integrationList. Agents use the same REST API as curl and the SDK.
OAuth2 for apps
OAuth2 appsuser consent workspace tokens
Register your app under Developers → Apps. Users approve access to their workspace, then your app calls the public API for Bluesky publishing without pasted workspace keys.
# Redirect the user to approve your app
https://www.openquok.com/oauth/authorize?client_id=oqc_your_client_id&response_type=code&state=random123
# Exchange the code for an opo_ access token, then call:
curl -H "Authorization: Bearer opo_oauth_access_token" \
https://api.openquok.com/api/v1/public/integrations
# Match identifier: bluesky — copy id into integrationIdsPricing
Transparent pricingfor Bluesky posting API
Every paid plan includes Public API access, the Node SDK, MCP tools, and OAuth apps per workspace. Publish to Bluesky from REST, SDK, or MCP — start with a 7-day free trial, no credit card required.
Solo
Prototype Bluesky posting from curl, SDK, or MCP before you ship to customers.
Features
- 1 agent workspace
- Total 15 channels
- 500 posts per month
- Unlimited AI Writer (experimental)
- Unlimited AI Summarizer (experimental)
- Public API access
- 1 OAuth app
- 1 MCP server (same OAuth connection)
- Total 5.0 GB cloud storage
- Official platform APIs
- Multi-channel publishing
Self-host for $0
OpenQuok charges no software fee when you run it on your own infrastructure. You still pay for servers, Supabase, and bandwidth.
Hosted cloud Cloud billing Docker Compose Cloud production stack Self-hosting overview
API examples FAQ
Bluesky Posting API,answered
Connect Bluesky, build a valid POST /public/posts payload, and publish from your app or agent.