Bluesky

Bluesky Posting API: Publish & Schedule Bluesky Posts

You can add Bluesky to the same integration as X, Threads and LinkedIn - one API key, scheduling included, and no AT Protocol sessions for you to manage.

Free plan · 2 accounts · No credit card · API + MCP included

SEND FROMYour appAI agentn8n / ZapierPOST /v1/posts · BLUESKY← publishedWoopSocialNo app reviewValidatesession handledDraft copy300 charsScheduleFri 17:00Publishon scheduleyour_brandBlueskyPOST000webhook
  • Text posts
  • Image posts
  • Multi-image posts
  • Video posts
  • Scheduled posts
  • Drafts

Last updated 29 October 2026. The BlueSky 300-character limit, the 4-image cap & the 3-minute video limit below are stated as of that date.

Reviewed by Attila Kun, Technical Co-founder. Last updated 29 October 2026.

What is the Bluesky Posting API?

The Bluesky Posting API is Bluesky's own open AT Protocol. Of all social media APIs, this is the most open one. There is no app review and also no paid tier. Authentication uses app password. However, publishing directly has no native scheduling, so you need to build your own queue and handle session tokens.

WoopSocial helps you use the Bluesky API without maintaining another integration for it. It helps with scheduling and drafts, sessions management and image uploads. You can post to BlueSky, X and Threads with one key - plus it's free for up to 2 accounts.

WoopSocial vs the Bluesky API (AT Protocol)

Comparison of the AT Protocol direct versus WoopSocial for posting
AT Protocol directWoopSocial
App passwords and session tokens to store and refreshConnect through WoopSocial’s authorization flow, with sessions handled
Upload images as blobs, then reference them in the post recordUpload once, and WoopSocial handles the blob flow
No scheduling, so you build a queue and a workerSCHEDULE_FOR_LATER and drafts
One more integration to maintainThe same key as 8 other platforms

Three steps to automated Bluesky posting

  1. Step 1

    Connect your account

    Send yourself, or your own users, a hosted connect link and they approve access in a few clicks. Bluesky accounts connect through the same authorization flow as every other platform, and WoopSocial manages the sessions for you.

  2. Step 2

    Create the post

    Send one request that targets Bluesky, X and Threads together. Each platform gets its own text through contentOverride, which helps because Bluesky allows 300 characters and X allows 280. Use SCHEDULE_FOR_LATER with a UTC timestamp to queue it/save a draft.

  3. Step 3

    We handle the rest

    WoopSocial uploads your images or video, then publishes at the scheduled time. Temporary failures retry automatically, and webhooks tell your app when a post goes out or fails.

Everything you need to ship Bluesky features

The short-form trio

For Bluesky, X and Threads, you can write one message, then adapt it for each platform with contentOverride.

Scheduling & drafts

The AT Protocol has no native scheduling. WoopSocial adds it. You can schedule a designated time in UTC or save a draft for later.

Images and video handled

Add up to 4 images with alt text, or a video. WoopSocial resizes your media and runs the upload.

Delivery webhooks & retries

Know when a post is published or has failed. Temporary problems are retried automatically.

AI agents

Add WoopSocial's MCP server to your assistant and ask for Bluesky posts in plain language. See the Hermes, Muse and Grok pages.

Three ways in

REST, MCP, n8n/Zapier/Make.

  1. 1 · Account

    Create a free WoopSocial account

    Sign up at app.woopsocial.com/signup (no credit card). You'll authorize through OAuth when the agent connects — no API key required for MCP.

  2. 2 · Bluesky

    Connect your account

    Link a Bluesky account in the WoopSocial dashboard before you ask an agent to post. WoopSocial manages the session. No app password handling of your own.

  3. 3 · Agent

    Add the MCP URL and authorize

    Use https://api.woopsocial.com/mcp. Your client opens OAuth — approve access and you're connected. Docs: Integrating MCP clients.

Install by client

Pick your agent. Cards marked On this site open another WoopSocial page; External opens outside this site (new tab).

Config for Cursor / other MCP clients

Prefer 1-click? Install the WoopSocial Cursor plugin. Or paste this into .cursor/mcp.json (or your client's MCP config). Authorize with OAuth when prompted — no API key in the URL. Allowlist *.cloudflarestorage.com if media uploads are blocked.

json
{
  "mcpServers": {
    "woopsocial": {
      "url": "https://api.woopsocial.com/mcp"
    }
  }
}

Claude Code

One command registers the remote HTTP MCP server. Complete OAuth when prompted.

bash
claude mcp add --transport http woopsocial "https://api.woopsocial.com/mcp"

After install — try this

Plain-language Bluesky prompt

You

Post this to Bluesky and Threads now, and schedule the X version for 9am

Prefer a full walkthrough with screenshots? Start at /social-media-mcp.

REST API example: schedule a post to Bluesky

Same POST /posts call with a Bearer API key. Authorization header and request body included.

bash
curl -X POST https://api.woopsocial.com/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": [{
      "text": "Shipping this week."
    }],
    "schedule": {
      "type": "SCHEDULE_FOR_LATER",
      "scheduledFor": "2026-07-03T17:00:00Z"
    },
    "socialAccounts": [{
      "platform": "BLUESKY",
      "socialAccountId": "YOUR_BLUESKY_ACCOUNT_ID"
    }]
  }'

Prefer a calendar? Schedule Bluesky posts from the dashboard

Want a Bluesky scheduler you don't have to code? The WoopSocial dashboard has a calendar where you can schedule Bluesky posts by choosing the date and time for each - something the AT Protocol doesn't do natively. With WoopSocial, you can connect more than one account and manage them side by side, which suits agencies and anyone running several brands. AI captions and cross-posting are available features. The dashboard runs on the same backend as the API, so a post your team schedules in the calendar behaves exactly like one your code creates. The free plan includes 2 accounts and needs no credit card.

Schedule from the dashboard
WoopSocial calendar for scheduling Bluesky posts

Bluesky requirements & limits

  • Characters

    Posts can be up to 300 characters, 20 more than X allows.

  • Images

    Each post can include up to 4 images, and alt text is supported. Adding alt text makes your posts accessible to more people.

  • Video

    Video can run up to 3 minutes. Trim longer recordings before you schedule them.

Cross-post to

X, Threads, LinkedIn.

FAQ

Can I schedule Bluesky posts via API?

Yes. Since there is no native scheduling for AT Protocol, users publishing directly would build a queue. However, with WoopSocial you can set SCHEDULE_FOR_LATER and a UTC timestamp, and the post is published at that time. You can also save it as a draft first.

Do I need to handle AT Protocol sessions or app passwords myself?

No. You connect your Bluesky account through WoopSocial's authorization flow and WoopSocial handles the sessions.

Can I post images and video to Bluesky?

Yes. A post can allow up to 4 images with alt text or a video of up to 3 minutes.

Can I post to Bluesky, X and Threads in one call?

Yes. Add all three as targets in one request, along with providing each with its own text with contentOverride. This helps because Bluesky allows 300 characters and X allows 280.

Can I post multi-post threads?

Not at this time. Every WoopSocial post includes only one content item, so when you submit a request, it will only create a single Bluesky post - not a thread of replies. You can schedule multiple posts to go out at various times, but they won't be linked together as a thread. You can also save it as a draft first.

Does it include Bluesky analytics?

Yes. WoopSocial returns Bluesky analytics, so you can use WoopSocial for engagement. You can also use WoopSocial to get Bluesky analytics for your account.

Can AI agents post to Bluesky?

Yes. WoopSocial's MCP server works in Claude, ChatGPT and Cursor, so you can ask an assistant to write and schedule a Bluesky post in plain language. You have nothing to worry about as your AI client asks for approval before anything is published. Our guide to scheduling social media posts with MCP covers the whole setup.

Is it possible to edit or cancel a scheduled Bluesky post?

Yes, you can. After the Bluesky post has been scheduled on the WoopSocial platform, you can still edit it or cancel it before it actually gets pushed to Bluesky. This includes editing content, but also the scheduled time.

What happens when my Bluesky session expires?

If your Bluesky session expires on the regular API, you need to refresh the token - this means logging in manually again to authenticate your account. WoopSocial automatically refreshes tokens for you, so your account can continuously be used to schedule and publish posts.

Post to more than Bluesky

Same API key. Same request format. Same across all the networks listed below. One integration for all of these networks.

Start posting to Bluesky today

“I connected WoopSocial's MCP to my AI agents, now I can post directly to all my social channels with just one command. Whenever I finish some website work or wrote a new blog post, I simply tell the AI agent to post it directly to my social media channels via WoopSocial. The content generation and bulk scheduling via the web app is also very useful. The time I spent managing social media has been reduced drastically. Gamechanger!”

Chris

Connect a Bluesky account, grab a free API key and schedule your first post in minutes. No credit card.

Free plan · 2 accounts · No credit card · API + MCP included