Social Accounts

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

Reconnecting: if the handle is already connected for the same tenantId, the existing account is replaced (credentials and profile refreshed) instead of duplicated. Connecting the same handle under a different tenantId creates a separate account.

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

  • Base URL: https://api.outstand.so
  • URL: https://api.outstand.so/v1/social-accounts/bluesky
  • Auth: none declared

Request body

handlestring required

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

appPasswordstring required

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

tenantIdstring

Optional tenant ID to associate with this account

Example request

{
  "handle": "user.bsky.social",
  "appPassword": "xxxx-xxxx-xxxx-xxxx",
  "tenantId": "tenant_123"
}

Response

Bluesky account connected successfully

successboolean required

Example response

{
  "success": true,
  "data": {
    "id": "9dyJS",
    "orgId": "org_abc123",
    "tenant_id": "tenant_123",
    "nickname": "My Company Twitter",
    "network": "x",
    "username": "@mycompany",
    "profile_picture_url": "https://example.com/profile.jpg",
    "network_unique_id": "123456789",
    "network_webhook_reference_id": "17841469709963147",
    "customer_social_network_id": 5,
    "accountType": "organization",
    "isActive": 1,
    "createdAt": "2025-01-15T10:30:00Z",
    "tokens": {
      "access_token": "ya29.a0Af..."
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.