How to connect Farcaster to Postozo
Paste a few details from Farcaster 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 Farcaster account.
- A signer from Neynar, approved in the Farcaster app, and its UUID.
- The Neynar API key of the same app, unless your server admin already added one.
Farcaster connects with details you copy from Farcaster (a key, token or app password). Postozo checks them with Farcaster before saving and stores them encrypted.
Connect Farcaster 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 Farcaster 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 Farcaster app keys yet. Ask the person who runs your Postozo server. On postozo.com this is done for you.
Step 2. Fill in your Farcaster details
A form opens. It asks for 2 details: Signer UUID, Neynar API key (optional). Under each field, press Where do I find this? to see the exact steps. We copy those steps below.
Signer UUID
- Sign in at dev.neynar.com and open your app.
- Create a signer (or use the Neynar signer flow in your own app).
- Open the approval link on your phone and approve it in the Farcaster app.
- Copy the signer UUID, for example 19d0c5fd-9b33-4a48-a0e2-bc7b0555baec.
Neynar API key (optional)
- In dev.neynar.com, open the same app that made the signer.
- Copy its API key.
- Leave it empty if your server admin already added a Neynar key.
Step 3. Press Connect
Postozo checks the details with Farcaster 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 Farcaster 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, like Farcaster 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 |
|---|---|
| "This signer is not approved" | Open the approval link from Neynar in the Farcaster app, approve it, then connect again. |
| "Neynar has no signer for this API key" | Use the signer UUID and the API key from the same Neynar app. |
| 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 Farcaster right now" | Farcaster 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 Farcaster 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 Farcaster
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 Farcaster. 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 Farcaster
Max 320 bytes of text (emoji and some letters use more than 1 byte). Up to 2 photos or videos, added as links. Optional channel in Settings. Follow-up comments become replies.
Read more on the Farcaster channel page.
First 3 things to do after connecting Farcaster
- Remember the limit is 320 bytes, not characters: emoji and some letters use more than 1 byte, and the editor counts it for you.
- Pick a Farcaster channel in the settings to post where your audience follows.
- Up to 2 photos or videos are added as links, and follow-up comments become replies.
What you can do once Farcaster is connected
Read from the same code that publishes to Farcaster, so it always matches the app.
| Farcaster | |
|---|---|
| Text per post | Up to 320 characters |
| Pictures or videos per post | Up to 2 |
| A post must have | Text, media or both |
| Settings in the post editor | Farcaster channel |
| First comment or thread | Yes |
| Analytics | No, Farcaster does not share statistics with apps |
| Auto actions | No |
| Bulk upload | Yes, name the channel in the channels column |
| Client reports | Yes, with posts but no network numbers |
Connect a client's Farcaster 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 Farcaster and fill in Signer UUID and Neynar API key themselves. Postozo checks the details with Farcaster, and the channel lands under their customer in your workspace. You never see what they typed.
More connection guides
Can I cast in a channel?
Yes. Set the Farcaster channel in the post settings.
How long can a cast be?
320 bytes. Emoji and some letters use more than 1 byte.
Does connecting Farcaster 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 Farcaster tile says Coming soon on this server?
The server you use has no Farcaster 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 Farcaster account?
Yes. Send them a client connect link. They connect Farcaster themselves and the channel lands under their customer.
Connect Farcaster now
Create your Postozo account and add your first Farcaster channel in a few minutes.
7 day free trial. No card needed.