Sign In Using Twitter

Sign-In Integrations in the Client Area

Twitter™ Sign-In Integrations let your customers connect with Twitter to quickly sign up for an account or log in to the Client Area.

This feature is not compatible with the Modern or Boxes order form templates.
For more information, see Sign-In Integrations.

Configuring Sign-In with Twitter

To use sign-in integrations with Twitter, you must create a Twitter app and API credentials.

  • WHMCS’s integration uses Twitter API v1.1. Some Twitter accounts will require Elevated access to use this version of the Twitter API.
  • You can integrate using your existing Twitter accounts. Users will only see the app name that you define. They will not see anything relating to the account that you use to create the app.
You can’t change the Twitter account under which you create the app without requiring users to reauthenticate and re-link their accounts.

To configure sign-in using Twitter on your WHMCS installation:

1. Create a Twitter App.

To create a Twitter app:

  1. Log in to your Twitter account.
  2. Go to the Twitter Developer Portal.
  3. Click Projects & Apps.
  4. In the left sidebar, click Overview.
  5. Click Create App.

2. Save the app credentials.

To save the app credentials:

  1. Enter an app name.
  2. Save the displayed API key and API secret key.

3. Configure callback URLs.

To configure OAuth settings and callback URLs:

  1. In the app settings, click Set Up under User Authentication Settings.
  2. Enable OAuth 2.0.
  3. Set Type of App to Web App.
  4. Enter the URL for your Client Area as the callback URL and website URL.
    • You must enter a valid callback URL.
    • We recommend adding all three possible callback URLs, replacing http://example.com/whmcs/ with your WHMCS installation URL:
      • http://example.com/whmcs/index.php
      • http://example.com/whmcs/index.php/auth/provider/twitter_oauth/callback
      • http://example.com/whmcs/auth/provider/twitter_oauth/callback
  5. Click Save.

4. Configure the App in WHMCS.

To enable sign-in integrations with Twitter in your WHMCS installation:

  1. Log in to the WHMCS Admin Area.
  2. Go to Configuration () > System Settings > Sign-In Integrations.
  3. Select Activate under Twitter.
  4. Enter your Twitter API Key for ConsumerKey and the API Secret for ConsumerSecret.
  5. Click Save & Activate.

WHMCS will attempt to validate and test the details that you have entered. If the credentials are valid and successfully authenticate with the Google API, the system will save them.

Common Errors

You may see the following common errors while setting up sign-in integrations with Twitter:

Error MessageDescriptionRecommended Solution
Invalid details not saved. Please verify your details and try againYou may receive the above error message when attempting to configure your Twitter API credentials. It usually indicates that you entered invalid API credentials or misconfigured the callback URLs.Check whether you entered your credentialss and callback URLs correctly.
Unable to access Sign-In Integrations pageIf you already have the necessary administrator role permissions, inability to access the interface at Configuration () > System Settings > Sign-In Integrations may indicate an issue in your Friendly URLs configuration.Check your Friendly URLs configuration for issues.
Social login: Error We could not connect to your accountThis error indicates an issue with a custom System Theme template.Change to the Six or Twenty-One themes and check whether the error continues. If it does not, this confirms that the issue is in the custom theme. Contact the system theme template developer for help.
We were unable to connect your account. Please contact your system administratorThis error indicates a misconfiguration in the callback URL in your Twitter app settings or that your Twitter account does not have access to Twitter API v1.1.Make certain that you have configured the callback URLs correctly. If the issue does not resolve, request Elevated access from Twitter.
Link Initiated! Please complete sign in to associate this service with your existing account. You will only have to do this once or Link Initiated! Please complete the registration form belowThis is a standard response when a client clicks Sign In With Twitter but has not yet linked their account.The client will need to log in with their Client Area email address and password to successfully link their Twitter account to it.

Last modified: October 25, 2024