// Social integration · 3 steps · ~2 min

Bluesky Setup

The easiest of all the social setups. Bluesky is built on open protocols, no developer program, no app review, no OAuth dance. Two minutes and you're done.

// You will end up with
  • social_bluesky_handle, your handle like artdrop.bsky.social or a custom domain
  • social_bluesky_password, a 19-character app password formatted xxxx-xxxx-xxxx-xxxx
// One important thing

Bluesky only shows the app password once. Copy it immediately when it appears, if you close the dialog without saving, you can't recover it, you have to revoke and make a new one. Same rule as any API key.

  1. 1
    Bluesky

    Know your handle

    Your handle is what you type when you log in. It includes the full domain, with no @ prefix.

    • Default format: yourname.bsky.social
    • Custom domain (if you set one up): mike.stanhattie.com

    Check yours by opening your Bluesky profile, the handle shows under your display name. Copy the full thing, including the domain.

    Don't include the @ symbol. ArtDrop rejects @artdrop.bsky.social and accepts artdrop.bsky.social.

  2. 2
    App password

    Create an app password on bsky.app

    Works the same on web and mobile:

    1. Open bsky.app and log in.
    2. Hamburger menu (top left on web, avatar tap on mobile), then Settings.
    3. Open Privacy and Security.
    4. Tap App Passwords.
    5. Click Add App Password.
    6. Name it something you'll recognize later. Suggested: ArtDrop.
    7. Click Create App Password.
    8. Copy the password immediately. It's shown once in a dialog like abcd-efgh-ijkl-mnop, 19 characters with hyphens.

    The hyphens are part of the password, don't strip them. Treat this like an API key: don't commit it to git, don't post it in Slack.

  3. 3
    Paste and save

    Enter both values in ArtDrop

    Back in ArtDrop's Social page, Bluesky section:

    • Handle: your handle from Step 1 (no @, include the full domain).
    • App Password: the xxxx-xxxx-xxxx-xxxx string from Step 2.

    Hit Save. ArtDrop creates a session with com.atproto.server.createSession right away, a failed login shows up immediately.

// What app passwords can (and can't) do

Bluesky app passwords are intentionally limited. With this password, ArtDrop can:

  • Post, reply, like, repost, follow, and read on your behalf.

ArtDrop cannot:

  • Change your email or main password.
  • Delete your account or migrate it.
  • Create more app passwords.

If the password ever leaks, revoke it from the same App Passwords screen and make a new one. Revocation is instant, no waiting period.

// Common gotchas
  • Handle format: no @, must include the full domain. user.bsky.social works, @user.bsky.social doesn't, user doesn't either.
  • Hyphens in the password are part of it. Some people think they're separators, they're not, copy the whole 19-character string.
  • "Invalid identifier or password": either the handle or the app password is off. Double-check both; if unsure, revoke the app password and make a fresh one, you can't recover an existing one.
  • Custom domain handles: if you've set up a custom domain (you.example.com), that's your handle, not the old you.bsky.social one. Both technically still work, but use the canonical one.
  • Rate limits apply to the account, not the app password. Revoking and re-creating doesn't reset them.
  • Self-hosted PDS users: if you're on a custom PDS (not bsky.social), ArtDrop will auto-discover via DID resolution, no extra config needed. Mention it in a support ticket if things don't resolve.
// Stuck?

Bluesky setup almost never has issues. If ArtDrop is rejecting a password you just created, paste it into the bsky.app login page manually to confirm it works. If that fails too, revoke and retry. Otherwise email support@getartdrop.com.

Official reference: Bluesky docs, AT Protocol.

// Other platforms
Instagram Pinterest Facebook Threads