Are you happy with your logging solution? Would you help us out by taking a 30-second survey? Click here


Open source social sign on PHP Library. HybridAuth goal is to act as an abstract api between your application and various social apis and identities providers such as Facebook, Twitter and Google.

Subscribe to updates I use hybridauth

Statistics on hybridauth

Number of watchers on Github 2712
Number of open issues 37
Average time to close an issue 2 months
Main language PHP
Average time to merge a PR 9 days
Open pull requests 41+
Closed pull requests 18+
Last commit almost 2 years ago
Repo Created over 8 years ago
Repo Last Updated almost 2 years ago
Size 5.97 MB
Homepage https://hybridaut...
Organization / Authorhybridauth
Latest Releasev2.10.0
Page Updated
Do you use hybridauth? Leave a review!
View open issues (37)
View hybridauth activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating hybridauth for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

Hybridauth 3.0-rc3

Build Status Scrutinizer Code Quality Latest Stable Version Join the chat at

Hybridauth enables developers to easily build social applications and tools to engage websites visitors and customers on a social level that starts off with social sign-in and extends to social sharing, users profiles, friends lists, activities streams, status updates and more.

The main goal of Hybridauth is to act as an abstract API between your application and the various social networks APIs and identities providers such as Facebook, Twitter and Google.


Hybridauth provides a number of basic examples. You can also find complete Hybridauth documentation at

$config = [
    'callback' => '',
    'keys' => [ 'key' => 'your-twitter-consumer-key', 'secret' => 'your-twitter-consumer-secret' ]

try {
    $twitter = new Hybridauth\Provider\Twitter($config);


    $accessToken = $twitter->getAccessToken();
    $userProfile = $twitter->getUserProfile();
    $apiResponse = $twitter->apiRequest( 'statuses/home_timeline.json' );
catch(\Exception $e){
    echo 'Oops, we ran into an issue! ' . $e->getMessage();


  • PHP 5.4+
  • PHP Session
  • PHP cURL


To install Hybridauth we recommend Composer, the now defacto dependency manager for PHP. Alternatively, you can download and use the latest release available at Github.

Versions Status

Version Status Repository Documentation PHP Version
2.x Maintenance v2 v2 >= 5.3
3.x Development v3 v3 >= 5.4

Questions, Help and Support?

For general questions (i.e, how-to questions), please consider using StackOverflow instead of the Github issues tracker. For convenience, we also have a [low-activity] Gitter channel if you want to get help directly from the community.


Hybridauth PHP Library is released under the terms of MIT License.

For the full Copyright Notice and Disclaimer, see

hybridauth open issues Ask a question     (View All Issues)
  • over 3 years Fatal error: Class 'Facebook\Facebook' not found
  • over 3 years Call adapter methods with more than 2 arguments
  • over 3 years Google 401 Invalid Credentials
  • over 3 years Plurk provider not using https
  • over 3 years Use http_build_query() to set cURL options
  • over 3 years PayPal live (non-sandbox) mode not usable?
  • over 3 years Enable additional provider is complicated additional step
  • over 3 years New extension to include HybridAuth in CMS Made Simple V2 X
  • over 3 years OAuth2Client should correctly handle token error response
  • over 3 years Azure AD / Azure AD B2C provider
  • over 3 years Oophs. Error! Hybrid_Exception
  • over 3 years Support for oauth bearer token
  • over 3 years Branch 3.0.0-Remake not updated for almost a year
  • over 3 years Yahoo Login Issue.
  • almost 4 years Error 400: redirect_uri_mismatch
  • almost 4 years Get steam ID
  • almost 4 years Set google scope, user cover
  • almost 4 years Cakephp Hybrid Auth not writing associated models in user session.
  • almost 4 years Disconnect provider
  • almost 4 years [provider] Uber
  • almost 4 years Document error about ver 3-remake settings for composer
  • almost 4 years error code 6: "User profile request failed. Most likely the user is not connected to the provider and he should to authenticate again".
  • almost 4 years HybridAuth install without Composer?
  • about 4 years Hybridauth Not pulling email id after facebook authentication
  • about 4 years Scope for Window Live: wl.basic or wl.signin
  • about 4 years [provider] Coub
  • about 4 years [provider]Glassdoor
  • about 4 years [provider] Meetup
  • about 4 years User profile request failed. Most likely the user is not connected to the provider and he should to authenticate again in Facebook
  • about 4 years Can't Get User Info While Login With Facebook IN Codeigniter Hybridauth
hybridauth open pull requests (View All Pulls)
  • Fixes redirect in auth after user pushes the browser back button
  • fix
  • Adding function to list Github repositories
  • Google plus api correct age values
  • Directly check the returned Facebook code for getting an access token
  • Fixing issues pointed out by Sensio Insight
  • Added actual coding standards
  • Make use of the redirect mode
  • Create BitBucket.php
  • Add Weibo Provider.
  • New QQ Provider.
  • Update URLs and small fixes with reformat
  • Adding Pinterest provider
  • Update OAuth2Client.php
  • Duplicate conditional expression in Sina.php
  • Workaround for Windows Live authentication
  • Fix PHP Notice when $_SERVER["QUERY_STRING"] is not defined.
  • Added ability to set LinkedIn's fields
  • Add custom endpoint documentation
  • Update Tumblr.php
  • Correct age range on Google+
  • [Pinterest] Additional provider updates
  • Update IDProvider_info_Facebook.html
  • Update Facebook Provider - Fixes #665
  • [LinkedIn] Add current organization and job title to the user profile
  • Modifying of Tumblr function for posting.
  • [Core] Patch for passing more arguments in called method
  • Update Plurk.php
  • Update GitHub provider to recognize verified email
  • add envato oauth
  • Removed unset() which breaks PHP 7.1 compatibility
  • [Stripe] Add documentation
  • [Stripe] Add new provider
  • Add composer.lock to gitignore
  • [Vimeo] Update documentation for OAuth 2.0
  • [Vimeo] Upgrade to OAuth 2.0
  • [Documentation] Fix disqus widget and issue with http / https
  • [LinkedIn] Update documentation for OAuth 2.0
  • [LinkedIn] Upgrade to OAuth2
  • Improved HumanitarianID support and removed thirdparty
  • Use PHPUnit\Framework\TestCase instead of PHPUnit_Framework_TestCase
hybridauth questions on Stackoverflow (View All Questions)
  • Fetch hybridauth data of a user in drupal7
  • Connect with Facebook (popup) using HybridAuth
  • HybridAuth getUserProfile returns Trying to get property of non-object
  • Cannot catch an Exception while authenticating user with HybridAuth
  • User profile request failed. Most likely the user is not connected to the provider and he should to authenticate again in HybridAuth
  • hybridauth: Invalid Scopes: read_stream
  • unable to get the data from facebook in codeigniter using hybridauth . Anyone Suggest?
  • Google login in redirect loop using HybridAuth
  • How to use hybridauth plugin with CakePHP 3.x?
  • HybridAuth authentication cookie
  • WP Multisite wrong url on HybridAuth
  • Social login with HybridAuth
  • Get information from contacts through hybridAuth
  • HybridAuth: How to ask for extra permission for exisiting user?
  • HybridAuth Facebook returned an invalid user id
  • hybridauth - how to minimize permissions?
  • How to get the Twitter user's email using Hybridauth?
  • Fatal error: Class 'Hybrid_Exception' not found in /hybridauth/Hybrid/Endpoint.php on line 205
  • Best way to login user via hybridauth
  • Nginx showing 502 bad gateway for hybridauth return url
  • Social login hybridauth and parse php
  • HybridAuth blank page when it make a connexion with google
  • Zend Framework 2 autoloading hybridauth Library
  • Crawl errors in hybridauth callback scripts
  • Sign up with linkedin not working ( using hybridauth )
  • Using AJAX to submit hybridauth
  • HybridAuth send notifications through AJAX in PHP
  • How to implement HybridAuth VIA ajax call?
  • Hybridauth: How can I allow user to choose Facebook account after they log out?
  • Hybridauth Twitter in yii framework
hybridauth list of languages used
hybridauth latest release notes
v3.0.0-rc.3 v3.0.0 RC 3

v3.0.0-rc.3 (2018-02-24)

Bug Fix

  • #923 - [Instagram] Fix issue with missing client_id or access_token URL parameter. (@ApacheEx)


  • #920 - Improve ProviderId setter for custom providers (@ApacheEx)

New Providers

  • #917 - SteemConnect provider integration. (@bencagri)
v3.0.0-rc.2 v3.0.0 RC 2

v3.0.0-rc.2 (2018-02-10)


  • #911 - [PHPUnit] Use PHPUnit\Framework\TestCase instead of PHPUnit_Framework_TestCase. (@carusogabriel)
  • #912 - [Facebook] Add setPageStatus possibility. Fix issue with appsecret_proof when posting to facebook page. (@ApacheEx)


It seems the last RC before releasing 3.0. The final release will include documentation improvements and fixes.

v3.0.0-rc.1 v3.0.0 RC 1

v3.0.0-rc.1 (2018-01-06)

Bug Fix

  • #900 - [Odnoklassniki] Add access_token key to params. (@mihdan)
  • #901 - [AbstractAdapter] Re-initialize token parameters when setAccessToken is called. (@ApacheEx)
  • #841 - [OpenId] Add support for variable namespace alias for SREG attributes (@CybotTM)


  • ce53ed5c8bdfcb96fe420ddc26fd058fc740be64 - Updated (@ApacheEx)
  • #898 - Fixed typo in documentation example. (@bkonetzny)
  • #907 - Clean up. Add new example. Coding Standards fixes (@ApacheEx)
Other projects in PHP