Sign in
Connect

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

Request body

identifierstring required

Your Bluesky handle (e.g. user.bsky.social) or email address

appPasswordstring required

App password generated from Bluesky Settings > App Passwords

statestring required

Required state formatted as {userId}-{profileId}. Get userId from GET /v1/users and profileId from GET /v1/profiles.

redirect_urlstring uri

Optional URL to redirect to after successful connection. Used when the state carries no redirect (a state minted by GET /v1/connect/bluesky with redirect_url already carries one, and that one wins).

redirectUristring uri

Alias of redirect_url, kept for existing callers

Example request

{
  "state": "6507a1b2c3d4e5f6a7b8c9d0-6507a1b2c3d4e5f6a7b8c9d1"
}

Response

Bluesky connected successfully

messagestring

Changes