Skip to content

Guides

How to post to Bluesky with the SkedCast API

Bluesky publishing goes through the AT Protocol adapter. Its overrides cover an external-link embed card and the platform's four self-label content flags (sexual, nudity, porn, graphic media) — there's no privacy/visibility field, since Bluesky posts are public by design.

Browse docs

6 min read

Before you publish#

You need one already-connected account for the platform. Connect it yourself in the Agency Console, or — if a client owns the account — mint a self-serve connect link with POST /clients/:id/connect-invites and send it to them; they authorize from that page without ever getting a SkedCast login.

GET /v1/accounts lists what's connected, with each account's id — that id is what you pass in targets.accountIds below.

Compose and schedule#

bash
curl -X POST https://api.skedcast.com/v1/posts \
  -H "Authorization: Bearer sked_live_YOUR_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "<clientId>",
    "content": "Launch day is here 🚀",
    "mediaIds": ["<mediaAssetId>"],
    "targets": { "mode": "selection", "accountIds": ["<blueskyAccountId>"] },
    "schedule": { "type": "at", "scheduledAt": "2026-07-01T15:00:00Z" }
  }'
A minimal bluesky post, scheduled for a specific time.

The Bluesky API post fields#

Everything platform-specific goes in one variants entry with "platform": "bluesky" and an overrides object. The adapter reads only the keys it declares (below) and ignores the rest — send bluesky keys on a bluesky variant, nothing more.

FieldTypeValues / defaultNotes
linkstring (url)External link for an embed preview card.
labelSexualbooleanfalseSelf-labels the post as sexually suggestive.
labelNuditybooleanfalseSelf-labels the post as containing non-sexual nudity.
labelPornbooleanfalseSelf-labels the post as adult/pornographic content.
labelGraphicMediabooleanfalseSelf-labels the post as violent or otherwise graphic media.
firstCommentstringPosted as a reply in the same thread, with link facets resolved like any other post. Posted right after publish. Best-effort: a failed comment never fails the post and is not reported, so verify on the published post.

Verbatim from the REST API reference's Bluesky table.

With the platform-specific overrides#

json
{
  "clientId": "<clientId>",
  "content": "New post on the blog — link below.",
  "mediaIds": [],
  "targets": { "mode": "selection", "accountIds": ["<blueskyAccountId>"] },
  "variants": [
    { "platform": "bluesky", "overrides": { "link": "https://example.com/blog/launch" } }
  ],
  "schedule": { "type": "at", "scheduledAt": "2026-07-01T15:00:00Z" }
}
The same POST /posts body, with a variants entry added.

Checking the result#

Publishing fans out into one post target per account. GET /post-targets/:id (or GET /posts/:id) reports status, plus externalId (bluesky's own post id) and permalink (its public URL) once published. Subscribe to the target.published / target.failed webhooks instead of polling if you can accept inbound HTTP — see the webhooks guide.

blueskyatprotoapipublish

FAQ

Does SkedCast's Bluesky adapter use the official AT Protocol client identity?
Yes — connecting a Bluesky account authenticates over the AT Protocol like any other AT Proto client; publishing calls the same `putRecord`-style write the protocol defines, so a published post is indistinguishable from one made in the Bluesky app.

Ready to broadcast everywhere?

Sign up free — no credit card. You land on the Free plan, and you can start a one-time 7-day Studio trial from your workspace whenever you are ready. Connect your first accounts, import a batch, and watch one post fan out across every platform.