Sign In Using Google

Sign-In Integrations in the Client Area

Google® Sign-In Integrations let your customers connect with Google 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 Google

To use sign-in integrations with Google, you must create a Google Developer Project and API credentials. You can do this using your existing Google account. 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 Google account under which you create the app without requiring users to reauthenticate and re-link their accounts.

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

1. Create a Google Developer Project.

To create a Google Developer Project:

  1. Go to the Google Developer Console.
  2. Log in to your Google account.
  3. At the top of the page, click Select a project.
  4. Click New Project.
  5. Enter a project name.
    Entering a Project name
  6. Click Create.
  7. Select Credentials in the left sidebar.
  8. Click Create Credentials.
    Create Credentials
  9. Select OAuth client ID.
  10. Click Configure Consent Screen.
  11. Select External for User Type.
    Configuring the User Type
  12. Click Create.
  13. Add the details for your app’s information.
    Configuring App Information
  14. Add an app domain.
    Configuring a Google App Domain
  15. For each domain that you want to authorize, click Add Domain under Authorized domains and configure the desired domains.
    Configuring a Authorized domains
  16. Under Developer contact information, enter your email address.
  17. Click Save and Continue.

2. Create your credentials.

To create the credentials for your Google app:

  1. In the left sidebar, click Credentials.
  2. Click Create Credentials.
  3. Click OAuth client ID.
  4. Select Web application for Application type.
  5. Enter a name for your OAuth 2.0 client.
  6. Enter your full root domain in Authorized JavaScript origins.
  7. Enter your full root domain in Authorized redirect URI.
  8. Click Create.

3. Save your credentials.

Save the Your Client ID and Your Client Secret values that display in Google after you save your credentials:

Google Credentials

4. Configure the App in WHMCS.

To enable sign-in integrations with Google 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 Google.
  4. Enter your credentials for Google Client ID and Client Secret.
  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.

Troubleshooting

For more information, see Troubleshooting Authentication.

You may encounter the following common issues:


Error or IssueCauseNext Steps
Remote account linking via Google has failed. Please make sure that the system clock is set properlyThere is a problem with your system’s server time.Google Remote Linking Failures
Google Sign-In is unavailable at this time. Please try again later or Google Sign-In is unavailable at this time. Please try again later. Error: Not a valid origin for the client: http://example.com has not been whitelisted for client ID xxxxxYour app configuration in Google® is invalid or Google is accessing WHMCS using the wrong URL.Google Sign In Unavailable Errors
Verification for current settings failed validationResponse: {valid:false}The Authorized JavaScript Origins and Authorized redirect URIs settings are incorrect or the WHMCS System URL setting is using an insecure http:// connection.Google Verification Failures
Invalid details not saved. Please verify your details and try again.Your API credentials or callback URLs are invalid or there is a problem in your Authorized JavaScript Origins configuration.Invalid Details Errors
Social login: Error We could not connect to your accountThere is a problem in your system theme template.Social Login Errors
You are unable to access the Sign-In Integrations settings in the Admin Area.Your administrator role does not have the required permissions or there is a problem with your Friendly URLs configuration.Unable to Access Sign-In Integrations

Last modified: 2025 April 2