How to connect Bluesky to Postozo
Paste a few details from Bluesky and start scheduling. This guide shows where to find each detail, each screen in Postozo, and how to fix common errors.
What you need before you start
- A Bluesky account and its handle, for example yourname.bsky.social.
- An app password. It is a separate password just for apps. Never use your main password.
Bluesky connects with details you copy from Bluesky (a key, token or app password). Postozo checks them with Bluesky before saving and stores them encrypted.
Connect Bluesky step by step
Step 1. Open Add Channel
Sign in to Postozo. On the Calendar, press Add Channel at the top of the channel list. A window opens with a tile for every network. Find the Bluesky tile and press it. Each tile also has a How to connect link that opens this guide.
If the tile says Coming soon on this server, the server you use has not added its Bluesky app keys yet. Ask the person who runs your Postozo server. On postozo.com this is done for you.
Step 2. Fill in your Bluesky details
A form opens. It asks for 3 details: Handle, App password, Server. Under each field, press Where do I find this? to see the exact steps. We copy those steps below.
Handle
- Open Bluesky and go to your profile.
- Your handle is under your name, for example yourname.bsky.social or your own domain.
- Type it here without the @.
App password
- In Bluesky, open Settings, then Privacy and security, then App passwords.
- Press Add App Password and give it a name, for example Postozo.
- Leave "Allow access to your direct messages" off.
- Copy the password. It looks like abcd-efgh-ijkl-mnop and is shown only once.
Server
- Leave https://bsky.social if you signed up on the Bluesky app.
- Only change it if you run your own server (PDS). Then type its address.
Step 3. Press Connect
Postozo checks the details with Bluesky before it saves anything. If something is wrong, the form stays open and shows what to fix. Nothing is saved until the check passes. The details are stored encrypted.
Step 4. Check the new channel
Back on the Calendar, the new channel shows in the channel list on the left, with a small Bluesky badge on its picture. A message at the bottom says it is connected. You can now pick it in the post editor.
Step 5. Set your preferences
Press the 3 dots next to the channel to open its menu. From here you can set Preferences (default settings for every new post on this channel), edit time slots, move the channel to a customer, reconnect, turn it off or delete it.
Common errors and how to fix them
| What you see | What to do |
|---|---|
| "An app password looks like abcd-efgh-ijkl-mnop" | You typed your normal password. Create an app password in Bluesky settings and paste that. |
| "Bluesky did not accept that handle and app password" | Check the handle has no typing mistake and that the app password was not deleted. |
| A red message under a field | The value does not have the right format. The message says what it should look like. |
| "We could not reach Bluesky right now" | Bluesky did not answer. Wait 1 minute and press Connect again. |
| "Your plan allows N channels" | You reached the channel limit of your plan. Remove a channel you do not use, or upgrade in Billing. |
How to reconnect
If the Bluesky details stop working (for example you deleted the key or changed the password), Postozo marks the channel with a warning and pauses its posts. Press the 3 dots next to the channel, then Reconnect channel. The same form opens. Paste the new details and press Reconnect. The channel keeps its posts, time slots and preferences.
How to disconnect Bluesky
Press the 3 dots next to the channel, then Delete. Postozo removes the channel and deletes its stored details right away. Upcoming and draft posts for that channel are removed too. Posts that are already live stay on Bluesky. You need the admin or owner role in your workspace to delete a channel.
To cut access on the network side as well, delete the key, token or app password you created there.
Want to pause instead? Choose Disable Channel in the same menu. Its posts wait until you turn it back on.
What you can post on Bluesky
Max 300 characters. Up to 4 images (each under 976 KB) or 1 video. Follow-up comments become a reply thread.
Read more on the Bluesky channel page.
First 3 things to do after connecting Bluesky
- Keep posts under 300 characters, and use follow-up comments to make a reply thread.
- Images must be under 976 KB each, up to 4 per post. Make large photos smaller before you upload them.
- Add alt text to each image in the media library. Postozo sends it to Bluesky, so people who use screen readers know what the picture shows.
What you can do once Bluesky is connected
Read from the same code that publishes to Bluesky, so it always matches the app.
| Bluesky | |
|---|---|
| Text per post | Up to 300 characters |
| Pictures or videos per post | Up to 4 |
| A post must have | Text, media or both |
| Settings in the post editor | None; the post is just text and media |
| First comment or thread | Yes |
| Analytics | Yes, for the channel and each post |
| Auto actions | Yes: Auto Repost Posts and Auto plug post |
| Bulk upload | Yes, name the channel in the channels column |
| Client reports | Yes, with its numbers |
Connect a client's Bluesky without their password
Working for a client? Send them a client connect link instead of asking for their details. On the link page they pick Bluesky and fill in Handle, App password and Server themselves. Postozo checks the details with Bluesky, and the channel lands under their customer in your workspace. You never see what they typed.
More connection guides
Is my main password stored?
No. You give an app password, which you can delete in Bluesky at any time to cut access.
I run my own server. Does it work?
Yes. Put your server address in the Server field.
Does connecting Bluesky cost extra?
No. There is no extra charge per network. Each connected account counts as 1 channel toward the channel limit of your plan.
What if the Bluesky tile says Coming soon on this server?
The server you use has no Bluesky app keys yet. The server admin adds them in Admin, Networks. Press Notify me on the tile and you get 1 email when it opens.
Can a client connect their own Bluesky account?
Yes. Send them a client connect link. They connect Bluesky themselves and the channel lands under their customer.
Connect Bluesky now
Create your Postozo account and add your first Bluesky channel in a few minutes.
7 day free trial. No card needed.