Connect
Connect Bluesky via App Password
Connects a Bluesky account with its handle and an App Password. Create the App Password in Bluesky under Settings, App Passwords.
POST
header
x-api-key<token>Workspace API key, sent in the x-api-key header. Keys start with op_ and are created in the dashboard.
application/json- body
identifier*stringBluesky handle, email or DID, such as alice.bsky.social.
Length
1 <= length <= 253appPassword*stringA Bluesky App Password, in the form xxxx-xxxx-xxxx-xxxx.
Length
1 <= length <= 200reconnectId?stringId of an existing connection to re-authorize. Reconnecting does not use a plan slot.
Length
1 <= lengthprofileName?stringProfile to file the new connection under. It is created if it does not exist. When omitted, the workspace default profile is used. Ignored on reconnect.
Length
1 <= length <= 60Connected Bluesky account
application/json- response
connection*Example Request
import { Configuration, ConnectionsApi } from "@onepostly/sdk";const connectionsApi = new ConnectionsApi( new Configuration({ apiKey: process.env.ONEPOSTLY_API_KEY }));const response = await connectionsApi.connectBluesky({ body: { "identifier": "alice.bsky.social", "appPassword": "abcd-efgh-ijkl-mnop", "profileName": "Business" },});console.log(response);Example Response
{ "connection": { "id": "a1b2c3d4-e5f6-4a7b-8c9d-e0f1a2b3c4d5", "platform": "instagram", "displayName": "Onepostly", "handle": "@onepostly", "avatarUrl": "https://cdn.onepostly.com/avatars/onepostly.jpg", "status": "active", "tokenExpiresAt": "2026-10-25T10:00:00.000Z", "canAutoRenew": true, "authHealth": "healthy", "profileName": "Business", "xSubscriptionType": "Premium", "createdAt": "2026-08-25T10:00:00.000Z", "updatedAt": "2026-08-25T10:00:00.000Z" }}