How to setup my X (Twitter) account?

To connect your X (Twitter) account with Statuz, you'll need to create an app in the X Developer Portal, for free.

Don't worry as it's a super simple process that should not take you more than 2 minutes! Here's a step-by-step guide:

Screen for those who never created an app before

Steps:

1. Visit the X Developer Portal and sign in with your X account

2. If you already have created apps in the past, click "Create New App" and fill in:

   • App name: Choose any name (e.g. "Statuz Client")
   • Description: Brief description (e.g. "Statuz client for publishing posts")

3. If you never created an app before, click the "Sign up for Free Account" at the bottom of the page and fill in:

   • App use case: Statuz helps post to social media right from the Mac's menu bar. No more jumping between tabs or apps - just click, write, and share to X in seconds. You can write single posts or create threads, add photos and videos by dropping them in. Learn more at https://statuz.gg
   • Accept all the terms

After creating the app, X should show you the Consumer Keys right away in case you had apps before. if not, look for the "Projects & apps" tab, click the settings option. It's the entry underneath the project name.

Screen where you can find your consumer keys and regenerate when needed

1. Look for the "Keys and Tokens" tab and then:

   • Copy the "API Key" and "API Key Secret". You can "Regenerate" new keys at any time.
   • Open Statuz and paste these values in Settings > X (Twitter)

2. Back in the X Developer Portal, go to the "Settings" tab located next to "Keys and tokens" and then look for the "User Authentication setup" section and click "Edit":

   • App Permissions: Set to Read and write
   • Type of App: Select Native App
   • Callback URL: Enter statuz://oauth
   • Website URL: Enter https://statuz.gg

Screen where you can find the User authentication settings setup

Screen where you can configure the User authentication

That's it! Click "Save" and wait about 30 seconds for the changes to take effect. You can ignore any OAuth 2.0 tokens or other settings.

Return to Statuz and click "Connect" to start the authorization process. After authorizing, you'll see a green dot indicating your X account is successfully connected. Don't forget to mark the option "Enable posting" in the app settings before you start publishing posts.

Screen where you can enter your X api key and client secret to connect your account

If needed, you can regenerate your Consumer Keys anytime in the X Developer Portal. After updating the keys in Statuz, you'll need to go through the authorization process again.

Having trouble? Contact our support team at support@statuz.gg and we'll guide you through the setup process.