Skip to main content

How to enable X (Twitter) authentication

Set up X (Twitter) login by creating your developer account and generating OAuth credentials

Updated over 2 months ago

To enable players to log in using their X (formerly Twitter) account, you’ll need to set up a free developer account, create a project, and configure OAuth 2.0 credentials.

Step 1: Create your X Developer Account

  1. Open the X Developer Portal.

    • If you don’t have a Twitter account yet, sign up for one first, then reopen the portal link.

  2. In the signup flow, select “Sign up for Free Account” under the paid options.

  3. Accept all terms and conditions, and when prompted to describe your purpose, use the following text:

    We will use X/Twitter login via OAuth 2.0 for user authentication in our platform. In the future, we may read public tweets to enhance user experience. We will not post, send messages, or interact on behalf of users. Our use is limited to authentication and potential tweet reading.

  4. Submit the application to complete your developer account setup.

Step 2: Create and Configure Your Project

  1. In the developer portal, navigate to Projects & Apps → Dashboard.

  2. Click your default generated project and open the Settings tab to rename the project if needed.

  3. Select the default App within your project. From here, you can control how your app appears during login:

    • Project Name: Displayed to users during authentication.

    • App Icon: Shown beside your project name.

    • Description: Explains your app’s purpose to users during login.

Step 3: Set Up User Authentication

  1. Inside your App view (Projects & Apps → Your Project → Your App), scroll to User authentication settings and click Set Up.

  2. Under Type of App, select Web app, Automated App or Bot.

  3. Configure the required fields:

    • Callback URL: https://api.{YOUR_DOMAIN}/v1/signin/twitter/verify

      • Replace {YOUR_DOMAIN} with your domain (e.g. example.com).

    • Website URL: Your main domain with protocol (e.g. https://example.com).

  4. Optionally, fill in the additional fields to enhance your consent screen:

    • Organization name

    • Organization URL

    • Terms of Service: e.g. https://example.com/doc/general-terms-and-conditions

    • Privacy Policy: e.g. https://example.com/doc/privacy-policy

  5. Click Save to generate your credentials.

Step 4: Send Your Credentials to your Account Manager

  • After saving, you’ll be presented with your Client ID and Client Secret.

  • Make sure to store these securely — they are required to connect your website to the X (Twitter) login flow.

  • Send both the Client ID and Client Secret to your Account Manager to complete the integration process.

💡 Tip: Keep your credentials private. Anyone with access to your Client Secret could impersonate your app.

Related Articles
How to enable Telegram authentication
How to enable Google authentication
Did this answer your question?