Wallet-as-a-ServiceAuthenticationX (Twitter)

X (Twitter) Authentication

This guide walks you through setting up X (formerly Twitter) OAuth as a custom authentication provider for your UTXOS application.

Custom authentication providers are available on Pro and Scale plans. The Base plan uses UTXOS-managed X credentials.

Prerequisites

  • An X (Twitter) account
  • Access to the X Developer Portal
  • A UTXOS project on the Pro or Scale plan
⚠️

X Developer Portal access may require approval. Apply for access if you do not have an existing developer account.

Create X OAuth2 Application

  1. Navigate to the X Developer Portal.

  2. Create a new application or select an existing one attached to a project.

X Developer Dashboard

  1. In the User authentication settings section, click Set up or Edit.

User authentication settings

  1. Configure the authentication settings:
SettingValue
App permissionsRead
Type of AppWeb App, Automated App or Bot
Request email from usersEnabled

X authentication configuration

  1. In the App info section, configure the callback URL:
FieldValue
Callback URI / Redirect URLhttps://utxos.dev/api/auth
Website URLYour application URL

X app info configuration

  1. Save your changes.

  2. Navigate to Keys and tokens in your application settings.

  3. Find the OAuth 2.0 Client ID and Client Secret section and copy both values.

X keys and tokens

X OAuth2 credentials

Configure UTXOS Dashboard

  1. Open the UTXOS Dashboard and select your project.

  2. Navigate to Settings > Authentication.

  3. Select Twitter from the provider list.

  4. Enter your credentials:

FieldValue
Client IDYour X OAuth2 Client ID
Client SecretYour X OAuth2 Client Secret

  1. Toggle Enable to activate X authentication.

  2. Click Save changes.

X authentication settings in UTXOS dashboard

Verify the Integration

  1. Open your application and initiate the wallet connection flow.

  2. Select Login with X (or Login with Twitter).

  3. Complete the X authorization process.

  4. Confirm you are redirected back to your application with an active wallet session.

Troubleshooting

”Callback URL not approved” Error

The callback URL in your X application does not match the expected value. Verify that https://utxos.dev/api/auth is configured exactly as shown.

”This app is suspended” Error

Your X Developer account or application may be suspended. Check the X Developer Portal for account status and any required actions.

”Something went wrong” Generic Error

This often indicates a permissions issue. Ensure your application has the correct permissions set and that email access is enabled.

OAuth 1.0a vs OAuth 2.0

UTXOS uses OAuth 2.0. Ensure you are copying the OAuth 2.0 Client ID and Secret, not the OAuth 1.0a API Key and Secret.

Next Steps

GoogleApple