Laravel 11 Socialite: Implementing Twitter (X) Sign-In / Authentication

Why Use Social Login with Twitter (X) in Laravel Applications?

Twitter (X) has millions of active users worldwide. Adding X login (formerly Twitter login) to your Laravel app offers:

• Faster registration and login
• No need for users to create new credentials
• Higher conversion rates
• Access to basic profile data (name, username, email*)

*Note: Email access requires special approval in X Developer Portal since 2023 changes.

Also check our guides for: Google Sign-In | Facebook Login

Table Of Content

1 Prerequisites

• PHP 8.2+
• Composer
• MySQL or preferred database
• A Twitter/X Developer Account (free tier is usually enough for auth)

2 Introduction

In today's web applications, offering seamless social login options significantly improves user experience and boosts registration rates. Instead of forcing users to create yet another account and password, you can let them sign in quickly using their existing social profiles.

In this comprehensive guide, we'll walk you through implementing Twitter (now X) authentication in a Laravel 11 application using the official Laravel Socialite package combined with the Breeze starter kit for authentication scaffolding.

Laravel Socialite is a powerful, developer-friendly package that simplifies OAuth-based authentication with various providers. It is not included by default in fresh Laravel installations, but adding it takes just a single Composer command.

As of 2026, Laravel Socialite officially supports the following providers out of the box:

• Facebook
• X (formerly Twitter)
• LinkedIn
• Google
• GitHub
• GitLab
• Bitbucket
• Slack
• Twitch

Additional platforms are available through the community-driven Socialite Providers ecosystem.

In this tutorial, we'll focus specifically on X (Twitter) login — including setting up the developer app in 2026, handling OAuth configuration (noting OAuth 1.0a is default, with OAuth 2.0 available), gracefully managing cases where email may not be returned due to X's privacy restrictions, and integrating everything securely with Laravel Breeze.

By the end, you'll have a fully functional "Sign in with X" button that authenticates users and creates or logs them into your application — perfect for modern Laravel projects.

Let's get started!

3 Create a New Laravel 11 Project

3.1 Install Laravel Project

First, make sure your computer has a composer.
Use the following command to install new Laravel Project.

composer create-project laravel/laravel twitter-auth-app

Then, navigate to your project directory:

cd twitter-auth-app

3.2 Configure MySql Database

Upon logging in, the user's record will be stored in the database. This process involves accessing the .env file to input and define the database credentials.

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_x_auth
DB_USERNAME=root
DB_PASSWORD=

4 Install Required Packages

We will use Laravel Breeze as an example of our existing authentication implementation.

4.1 Install Breeze Package

Use the following command to Install Laravel Breeze Package

composer require laravel/breeze --dev

After Composer has installed the Laravel Breeze package, you should run the breeze:install Artisan command. This command publishes the authentication views, routes, controllers, and other resources to your application.

php artisan breeze:install
 
php artisan migrate
npm install
npm run dev

4.2 Install Socialite Package

Use the following command to Install Laravel Socialite Package

composer require laravel/socialite

5 Create Twitter (X) Developer Application

5.1 Login into Twitter Developer Account

If you have Twitter Developer Account Go to https://developer.twitter.com/, else you can easily create one directly from the Twitter Developers Portal.

5.2 Create an Application

"Add App" in the Twitter Developer Portal

Update App Info in the Twitter Developer Portal

After Creating application , you will receive a API Key and API Key Secrets. copy these keys into your .env file.

5.3 Setup User Authentication Settings

In Following Screen Click "Set up" Button to update settings


In Following Screen select "Read" Option and Enable Request email from users" Option In "Type Of App" select "Web App, Automated App or Bot" Option


It will redirected to the following screen and fill the detail about our app and fill the redirect URL. This is the URI that we will use to redirect user after they choose their Twitter account to login to our web. For example here I use http://127.0.0.1:8000/callback/twitter for the callback URI.


In Following Screen add a Privacy policy and Terms of Services URL

6 Configure Credentials in Laravel

6.1 Add the Twitter API Credentials in .env

Insert the Client ID and Client Secret key and redirect URI into the .env file, Which we obtained from previous step TWITTER_CLIENT_ID and TWITTER_CLIENT_SECRET. Additionally, include a new key in the .env file called TWITTER_REDIRECT_URI and populate it with the callback URI used in the Twitter API Console.

TWITTER_CLIENT_ID=Your Client ID
TWITTER_CLIENT_SECRET=Your Client Secret
TWITTER_REDIRECT_URI=http://127.0.0.1:8000/callback/twitter

6.2 Add the Twitter API .env key in config/services.php

Open the config/services.php file and Insert the Twitter OAuth Credentials

<?php

return [

    // Other services ..
    
    'twitter' => [
        'client_id' => env('TWITTER_CLIENT_ID'),
        'client_secret' => env('TWITTER_CLIENT_SECRET'),
        'redirect' => env('TWITTER_REDIRECT_URI'),
    ],
];
?>
    

6.3 Add New Column within the Users Table to Store twitter_id

Create a Laravel Migration to Add a New Column within the Users Table to Store twitter_id

php artisan make:migration add_twitter_id_to_users

In the generated new migration file, update the up and down methods as described below:

database/migrations/2024_05_24_120820_add_twitter_id_to_users.php

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->string('twitter_id')->after('password')->nullable()->unique();
        });
    }

    public function down()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->dropColumn('twitter_id');
        });
    }
};

Use the following command to run the migration to update your database.

php artisan migrate

6.4 Update the User Model

In your User model , Include twitter_id in the fillable array of the User Model.
app/Models/User.php

<?php
namespace App\Models;

// use Illuminate\Contracts\Auth\MustVerifyEmail;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;

class User extends Authenticatable
{
    use HasFactory, Notifiable;

    /**
     * The attributes that are mass assignable.
     *
     * @var array
     */
    protected $fillable = [
        'name',
        'email',
        'password',
        'twitter_id'
    ];

    /**
     * The attributes that should be hidden for serialization.
     *
     * @var array
     */
    protected $hidden = [
        'password',
        'remember_token',
    ];

    /**
     * Get the attributes that should be cast.
     *
     * @return array
     */
    protected function casts(): array
    {
        return [
            'email_verified_at' => 'datetime',
            'password' => 'hashed',
        ];
    }
}

?>

7 Create New Controller - TwitterLoginController

Now create a controller "TwitterSocialiteController" and add redirectToTwitter() and handleTwitterCallback() methods
Use the following artisan command to Create Controller.

php artisan make:controller TwitterSocialiteController

app/Http/Controllers/TwitterLoginController.php

<?php
namespace App\Http\Controllers\Auth;
use App\Http\Controllers\Controller;
use App\Models\User;
use Auth;
use Exception;
use Socialite;

class TwitterSocialiteController extends Controller
{
    public function redirectToTwitter()
    {
        // redirect user to "login with Twitter account" page
        return Socialite::driver('twitter')----->redirect();
    }

    public function handleCallback()
    {
        try {
            // get user data from Twitter
            $user = Socialite::driver('twitter')->user();
            // find user in the database where the social id is the same with the id provided by Twitter
            $finduser = User::where('twitter_id', $user->id)->first();

            if ($finduser)  // if user found then do this
            {
                // Log the user in
                Auth::login($finduser);

                // redirect user to dashboard page
                return redirect('/dashboard');
            }
            else
            {
                // if user not found then this is the first time he/she try to login with Twitter account
                // create user data with their Twitter account data
                $newUser = User::create([
                    'name' => $user->name,
                    'email' => $user->email,
                    'twitter_id' => $user->id,
                    'password' => bcrypt('my-twitter'),  // fill password by whatever pattern you choose
                ]);

                Auth::login($newUser);

                return redirect('/dashboard');
            }

        }
        catch (Exception $e)
        {
            dd($e->getMessage());
        }
    }
}
?>

8 Define a Route for Socialite Login with Twitter

Define routes for the TwitterSocialiteController in the web.php file
routes/web.php

Route::get('auth/twitter', [TwitterSocialiteController::class, 'redirectToTwitter']);  // redirect to Twitter login
Route::get('callback/twitter', [TwitterSocialiteController::class, 'handleCallback']);    // callback route after Twitter account chosen

9 Add Twitter Login Button to View

Create the Link in the login view to Show Twitter Sign-in Button
resources/views/auth/login.blade.php

<a href="{{ url('auth/twitter') }}">
 <img src="images/twitter_button.png">
</a>

10 Folder Structure

11 Test the Twitter (X) Authentication

Use the following artisan command to Test the App.

php artisan serve

Visit: http://127.0.0.1:8000/login → Click Twitter button → Authorize → Redirect to dashboard.

Common Issues & Troubleshooting

• Redirect URI Mismatch → Double-check exact URL in .env and X Developer Portal
• 401/403 Errors → Wrong keys, permissions not set, or app not approved for email
• Email is null → X restricts email; handle gracefully
• OAuth changes → For OAuth 2.0 use 'twitter-oauth-2' in config/services.php

12 Conclusion

You've successfully implemented Twitter (X) sign-in in Laravel 11 using Socialite! This feature adds professionalism and convenience to your application. For production, always use HTTPS, validate inputs, and monitor X API policy changes.

Frequently Asked Questions