Bluesky

Connect your Bluesky account to schedule and publish posts through Cue.

Overview

Bluesky is a decentralized social network built on the AT Protocol. Cue integrates with the Bluesky API to publish content on your behalf.

Authentication

Bluesky uses app passwords for API authentication. App passwords let you grant limited access to third-party apps without sharing your main password.

Creating an App Password

Go to bsky.app/settings/app-passwords
Sign in if needed
Click Add App Password
Give it a name (e.g., "Cue")
Copy the generated password (you'll need it in the next step)

Important: App passwords are shown only once. Store it securely or regenerate if lost.

Connecting Your Account

Create an app password on Bluesky (see above)
Go to Profiles in your Cue dashboard
Click Connect Account on a profile
Select Bluesky
Enter your Bluesky handle (e.g., alice.bsky.social)
Enter the app password you created
Click Connect

Cue validates your credentials and stores them securely for publishing posts.

Disconnecting

To disconnect your Bluesky account:

Go to your profile and click Disconnect next to the Bluesky connection
Optionally, revoke the app password in your Bluesky settings

Content Limits

Bluesky enforces the following limits on posts:

Limit	Value
Characters	300 (graphemes, not bytes)
Images	Up to 4 per post
Video	Not supported via API
File size	1 MB per image

Note: Bluesky counts graphemes (user-perceived characters), not bytes. Emoji, accented characters, and other Unicode characters count as 1 character.

Cue automatically validates your content length before publishing to prevent errors.

Publishing a Post

curl -X POST https://api.oncue.so/v1/posts \
  -H "Authorization: Bearer cue_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prf_abc123",
    "platforms": {
      "sac_bluesky1": {
        "items": [{ "content": "Hello from Cue!" }]
      }
    },
    "publishNow": true
  }'

const response = await fetch("https://api.oncue.so/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer cue_sk_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    profileId: "prf_abc123",
    platforms: {
      sac_bluesky1: {
        items: [{ content: "Hello from Cue!" }]
      }
    },
    publishNow: true,
  }),
});

Schedule for Later

curl -X POST https://api.oncue.so/v1/posts \
  -H "Authorization: Bearer cue_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prf_abc123",
    "platforms": {
      "sac_bluesky1": {
        "items": [{ "content": "Scheduled post content" }]
      }
    },
    "scheduledAt": "2024-01-20T09:00:00-05:00"
  }'

const response = await fetch("https://api.oncue.so/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer cue_sk_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    profileId: "prf_abc123",
    platforms: {
      sac_bluesky1: {
        items: [{ content: "Scheduled post content" }]
      }
    },
    scheduledAt: "2024-01-20T09:00:00-05:00",
  }),
});

Creating Threads

Create multi-post threads by including multiple items in the items array. Each item becomes a connected post in the thread.

Threads require a Growth plan or above.

curl -X POST https://api.oncue.so/v1/posts \
  -H "Authorization: Bearer cue_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prf_abc123",
    "platforms": {
      "sac_bluesky1": {
        "items": [
          { "content": "1/ A thread about decentralized social media..." },
          { "content": "2/ The AT Protocol enables true data portability..." },
          { "content": "3/ This means you own your social graph..." },
          { "content": "4/ The future of social is open and federated!" }
        ]
      }
    },
    "publishNow": true
  }'

const response = await fetch("https://api.oncue.so/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer cue_sk_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    profileId: "prf_abc123",
    platforms: {
      sac_bluesky1: {
        items: [
          { content: "1/ A thread about decentralized social media..." },
          { content: "2/ The AT Protocol enables true data portability..." },
          { content: "3/ This means you own your social graph..." },
          { content: "4/ The future of social is open and federated!" }
        ]
      }
    },
    publishNow: true,
  }),
});

Each post in a thread must respect the 300 character limit.

Response

{
  "data": {
    "id": "pst_xyz789",
    "profileId": "prf_abc123",
    "content": "Hello from Cue!",
    "status": "queued",
    "scheduledAt": null,
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  },
  "message": "Post queued for publishing to 1 platform(s)"
}

Error Handling

Bluesky API errors are translated into user-friendly messages:

Error Code	Meaning	Solution
`401`	Invalid credentials	Check your handle and app password
`400`	Content exceeds 300 characters	Shorten your content
`429`	Rate limit exceeded	Wait and retry later
Network error	Cannot reach Bluesky API	Check your internet connection