Need help with laravel-passport-social-grant?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

147 Stars 15 Forks MIT License 61 Commits 0 Opened issues


🔒 API authentication via social networks for your Laravel application

Services available


Need anything else?

Contributors list

Laravel Passport Social Grant

Packagist GitHub tag License Downloads tests

This package adds a social grant for your OAuth2 server. It can be useful if have an API and want to provide the ability for your users to login/register through social networks.

As a result you will be able to exchange

, issued by the OAuth2 server of any social provider, to
issued by your own OAuth2 server. You will receive this
and return the user instance that corresponds to it on your own.


You can install this package via composer using this command:

composer require coderello/laravel-passport-social-grant

The package will automatically register itself.


As the first step, you need to implement

: ```php <?php

namespace App\Resolvers;

use Coderello\SocialGrant\Resolvers\SocialUserResolverInterface; use Illuminate\Contracts\Auth\Authenticatable; use Laravel\Socialite\Facades\Socialite;

class SocialUserResolver implements SocialUserResolverInterface { /** * Resolve user by provider credentials. * * @param string $provider * @param string $accessToken * * @return Authenticatable|null */ public function resolveUserByProviderCredentials(string $provider, string $accessToken): ?Authenticatable { // Return the user that corresponds to provided credentials. // If the credentials are invalid, then return NULL. } } ```

The next step is to bind

to your implementation.

You can do it by adding the appropriate key-value pair to

property in
use App\Resolvers\SocialUserResolver;
use Coderello\SocialGrant\Resolvers\SocialUserResolverInterface;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider { /** * All of the container bindings that should be registered. * * @var array */ public $bindings = [ SocialUserResolverInterface::class => SocialUserResolver::class, ]; }

You are done!


Example of usage with

:'/oauth/token', {
    grant_type: 'social', // static 'social' value
    client_id: clientId, // client id
    client_secret: clientSecret, // client secret
    provider: providerName, // name of provider (e.g., 'facebook', 'google' etc.)
    access_token: providerAccessToken, // access token issued by specified provider
  .then((response) => {
    const {
      access_token: accessToken,
      expires_in: expiresIn,
      refresh_token: refreshToken,
    } =;

// success logic

}) .catch((error) => { const { message, hint, } =;

// error logic


Example of usage with

$http = new Client;

$response = $http->post($domain . '/oauth/token', [ RequestOptions::FORM_PARAMS => [ 'grant_type' => 'social', // static 'social' value 'client_id' => $clientId, // client id 'client_secret' => $clientSecret, // client secret 'provider' => $providerName, // name of provider (e.g., 'facebook', 'google' etc.) 'access_token' => $providerAccessToken, // access token issued by specified provider ], RequestOptions::HTTP_ERRORS => false, ]); $data = json_decode($response->getBody()->getContents(), true);

if ($response->getStatusCode() === Response::HTTP_OK) { $accessToken = Arr::get($data, 'access_token'); $expiresIn = Arr::get($data, 'expires_in'); $refreshToken = Arr::get($data, 'refresh_token');

// success logic

} else { $message = Arr::get($data, 'message'); $hint = Arr::get($data, 'hint');

// error logic



You can run the tests with:

composer test


Please see CHANGELOG for more information what has changed recently.


Please see CONTRIBUTING for details.


Created by Illia Sakovich

Maintained by Ankur Kumar


The MIT License (MIT). Please see License File for more information.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.