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 https://bsky.app/settings/app-passwords

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

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

const body = JSON.stringify({  "handle": "user.bsky.social",  "appPassword": "xxxx-xxxx-xxxx-xxxx"})fetch("https://api.outstand.so/v1/social-accounts/bluesky", {  method: "POST",  headers: {    "Content-Type": "application/json"  },  body})
{
  "success": true,
  "data": {
    "id": "9dyJS",
    "orgId": "org_abc123",
    "nickname": "My Company Twitter",
    "network": "x",
    "username": "@mycompany",
    "profile_picture_url": "https://example.com/profile.jpg",
    "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"
}