Connect Bluesky account

Connect a Bluesky account using identifier (handle or email) and an app password. To get your userId for the state parameter, call GET /v1/users which includes a currentUserId field.

POST /v1/connect/bluesky/credentials

Connect a Bluesky account using identifier (handle or email) and an app password. To get your userId for the state parameter, call GET /v1/users which includes a currentUserId field.

Request body

Content-Type: application/json

• identifier (string) required — Your Bluesky handle (e.g. user.bsky.social) or email address
• appPassword (string) required — App password generated from Bluesky Settings > App Passwords
• state (string) required — Required state formatted as {userId}-{profileId}. Get userId from GET /v1/users and profileId from GET /v1/profiles.
• redirectUri (string) — Optional URL to redirect to after successful connection

Example:

{
  "identifier": "yourhandle.bsky.social",
  "appPassword": "xxxx-xxxx-xxxx-xxxx",
  "state": "6507a1b2c3d4e5f6a7b8c9d0-6507a1b2c3d4e5f6a7b8c9d1",
  "redirectUri": "https://yourapp.com/connected"
}

Responses

200 — Bluesky connected successfully

• message (string)
• account ($ref)

400 — Invalid request - missing fields or invalid state format

401

500 — Internal error