Twitter (X)

Overview

Connect your users to Twitter (X) for reading tweets, posting content, managing follows, and accessing user data.

Property	Value
Provider ID	twitter
Category	Social
PKCE	Required
Token refresh	Automatic
Redirect URI	Shown in Developer Portal

Step 1: Create a Twitter OAuth App

Go to the Twitter Developer Portal

Navigate to developer.x.com/en/portal/dashboard and sign in.

Create a new project and app

Click Add App (or create a new Project first), enter the app name, and select the use case.

Configure OAuth 2.0

In app settings, under User authentication settings, enable OAuth 2.0. Set the Type of App to Web App. Add the Alter callback URL from the Developer Portal to the Callback URI field.

Get credentials

Copy the Client ID and Client Secret from the Keys and tokens tab.

Warning

Never share your Client Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Twitter provider

Go to OAuth Providers > Add Provider > Twitter (X).

Enter credentials

• Client ID: Paste your Twitter Client ID
• Client Secret: Paste your Twitter Client Secret

Select scopes

Choose the scopes the application needs.

Save

Click Save. The provider is now active.

Available Scopes

Scope	Description
tweet.read	Read tweets and timelines
tweet.write	Create and delete tweets
users.read	Read user profile data
follows.read	Read follows and followers
follows.write	Follow and unfollow accounts
like.read	Read liked tweets
like.write	Like and unlike tweets
offline.access	Obtain a refresh token for long-lived access
space.read	Read Twitter Spaces
bookmark.read	Read bookmarks
bookmark.write	Add and remove bookmarks

Notes

• Twitter OAuth 2.0 requires PKCE. Alter Vault handles this automatically.
• Always include offline.access to receive a refresh token.
• See the Twitter OAuth 2.0 documentation for more details.