Connect a Bluesky account

Connect a Bluesky account using handle and app password authentication. Bluesky uses app passwords instead of OAuth, so credentials are provided directly.

Prerequisites:

1. Configure Bluesky in your social networks: POST /v1/social-networks with network: "bluesky"
2. Create an app password at

Security Note: App passwords are scoped credentials that don't grant access to your main password. They can be revoked at any time from Bluesky settings.

POST/v1/social-accounts/bluesky

Request Body

application/json

handlestring

Bluesky handle (e.g., user.bsky.social)

Length1 <= length

appPasswordstring

Bluesky app password (from bsky.app/settings/app-passwords)

Length1 <= length

tenantId?string

Optional tenant ID to associate with this account

Response Body

201application/json

400application/json

409application/json

500application/json

JavaScript

Go

Java

C#

cURL

TypeScript

Python

Swift

const body = JSON.stringify({
  "handle": "user.bsky.social",
  "appPassword": "xxxx-xxxx-xxxx-xxxx"
})

fetch(" {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body
})

201400409500

{
  "success": true,
  "data": {
    "id": "9dyJS",
    "orgId": "org_abc123",
    "nickname": "My Company Twitter",
    "network": "x",
    "username": "@mycompany",
    "profile_picture_url": "
    "network_unique_id": "123456789",
    "customer_social_network_id": 5,
    "accountType": "organization",
    "isActive": 1,
    "createdAt": "2025-01-15T10:30:00Z"
  }
}

{
  "success": false,
  "error": "Session expired or invalid"
}

{
  "success": false,
  "error": "Account already connected"
}

{
  "success": false,
  "error": "Internal server error",
  "message": "Database connection failed"
}