What Farcaster Sync actually does

Farcaster Sync is a cross-posting tool that bridges X and Farcaster. When you connect your accounts, every post you make on X automatically appears on Farcaster. This saves time and keeps your audience on both platforms engaged without manual effort.

Think of Farcaster Sync as a bridge. It takes your X posts and moves them to Farcaster. You don't need to copy and paste. You don't need to switch apps. You just post on X, and Farcaster Sync handles the rest.

This tool is for creators who want to reach both audiences. It works in the background. You focus on writing. Farcaster Sync handles the distribution.

Prerequisites for your accounts

Before connecting X to Farcaster, gather the necessary credentials. This prevents interruptions during the sync process.

X API Access

You need an X API key and secret. Create a developer account at developer.x.com and generate credentials for your app. Note that free-tier access often lacks the write permissions required for posting. If you plan to share content, you may need a basic or pro tier subscription to enable posting capabilities.

Farcaster Identity

Secure your Farcaster account via Warpcast. Locate your Farcaster ID (FID) in your profile settings. You will also need your private key or a connected wallet to authorize the sync tool to post on your behalf.

Farcaster Sync

How to sync your X and Farcaster accounts

Connecting your X (formerly Twitter) account to Farcaster lets you cross-post content automatically. This setup uses an OAuth flow to authorize the connection securely without sharing your passwords. Once linked, your X posts can appear on your Farcaster feed, or vice versa, depending on your configuration.

Follow these steps to establish the connection using the Farcaster Sync interface.

Farcaster Sync
1
Log in to your Farcaster account

Start by accessing your Farcaster client or web interface. You need to be authenticated with your Farcaster account (identified by your FID) before you can link external social media accounts. If you are using a third-party client like Warpcast, ensure you are logged in via your connected wallet or session.

2
Navigate to the Sync settings

Locate the account settings or integrations menu within your Farcaster client. Look for a section labeled "Sync," "Connections," or "Social Media." This is where you manage external links. Click the option to add a new connection and select "X" or "Twitter" from the available platforms.

Farcaster Sync
3
Authorize via X OAuth

You will be redirected to X’s official authorization page. This is the critical security step. Review the permissions requested by the Sync service. Typically, this includes read access to your posts and write access to post on your behalf if you choose cross-posting. Click "Authorize" or "Allow" to grant these permissions. This creates the secure token that allows the two platforms to communicate.

4
Configure sync direction and frequency

After authorization, you will return to your Farcaster interface. Here, you can define how the sync works. Choose whether to sync X posts to Farcaster, Farcaster posts to X, or both. Some tools allow you to set filters, such as excluding replies or specific hashtags. Save your preferences to finalize the setup.

5
Verify the connection

Test the link by posting a simple status update on one platform. Wait a minute or two, then check the other platform to confirm the post appeared. If it does not appear, check the connection status in your settings to ensure the OAuth token is still valid. Most sync services provide a "Last Synced" timestamp to help you troubleshoot.

Fix common sync errors

When a sync fails, it usually comes down to three things: permission scopes, rate limits, or a stale connection. Most errors are easy to spot if you check the logs in the order below.

Permission denied or missing scopes

If the sync tool returns a 401 or 403 error, your X API credentials likely lack the required permissions. For read-only syncs, ensure your app has Read access to tweets and user profiles. If you are writing back to Farcaster, you must also enable Write access. Regenerate your API keys in the X Developer Portal and update your environment variables.

Connection timeouts

A timeout error means the sync tool cannot reach the Farcaster hub. This happens when the hub URL is incorrect or the network is congested. Verify the hub endpoint in your configuration file. If you are running a local hub, ensure it is fully synchronized before starting the sync. You can check the sync percentage by querying the hub directly.

Duplicate content errors

If the sync succeeds but posts appear twice, your script is likely not tracking the last processed ID. Always store the messageHash or timestamp of the last successful post. Before syncing new content, check if the ID already exists in your database to prevent duplicates.

Verify your sync is live

The setup is only as good as the data flowing through it. To confirm Farcaster Sync is working, you need to trigger a test post and watch the relay chain. This isn't about checking a dashboard; it's about seeing the content appear where it belongs.

Start by posting a unique test message on X. Use a phrase that won't appear elsewhere, like "Sync Test 123," to make verification unambiguous. Wait a few seconds for X to process the tweet, then switch to your Farcaster client.

Look for the post in your Farcaster feed. If the sync is active, the tweet should appear automatically. Check that the formatting, links, and media match the original X post exactly. If the post doesn't appear within a minute, check your connection status in the sync settings.

  • Post a unique test message on X
  • Wait 10-30 seconds for propagation
  • Verify the post appears in your Farcaster feed
  • Check that links and formatting are intact

Once you see your test post on both platforms, your automation is live. You can now post normally, knowing your audience on Farcaster will see your X content without manual effort.

Farcaster sync setup: what to check next

These answers address the most common technical hurdles when connecting X and Farcaster. Use the official Farcaster documentation as your primary reference for API endpoints and data structures.

How do I find a Farcaster fid?

The most reliable method is using the Postgres replicator. This tool indexes both onchain and offchain data, allowing you to query the fnames table directly. Run a SQL query like SELECT username, fid FROM fnames WHERE username = 'target_user' to retrieve the numeric ID. This approach is faster than using the API for bulk lookups.

How do I scan with Farcaster?

Scanning is typically part of the identity verification process. When a service displays a "Verify with Farcaster" button, it generates a QR code. Open your Farcaster mobile app, scan the code, and sign the authentication request. This links your Farcaster identity to the external platform securely.

How do I build viral Farcaster mini apps?

Building mini apps requires the MiniApp SDK and wallet integration. Start by installing the SDK and initializing the client. Use Wagmi for wallet connections and Quick Auth for seamless login. Configure your manifest file to define the app's behavior, then test environment detection before publishing. Viral potential comes from utility, not just code.