PostozoHow 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.
More connection guides
Questions
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.
Connect Bluesky now
Create your Postozo account and add your first Bluesky channel in a few minutes.
Create your free account