Sign In Using Facebook

Integrations in the Client Area

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

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

1. Create a Facebook App.

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

To create your app in Facebook:

  1. Visit the Facebook developer portal.
  2. Log in to your Facebook account.
  3. Click Create App.
  4. Select Consumer as the app type.
    Selecting a Facebook app type
  5. Click Continue.
  6. Enter a display name for App Display Name. This is the name that users see when authorizing your app. We recommend using your company name here.
    Entering app information
  7. Enter your email address for App Contact Email. The system uses this email address for important communication about your app.
  8. Click Create App.
  9. Under Facebook Login, click Set Up.
    Clicking Set Up under Facebook Login
  10. Select Web as your platform.
    Entering app information
  11. Enter the full URL to the root domain of your website.
    Entering a website URL
  12. Click Save.
  13. Click Continue.

2. Configure the App Permissions.

To configure the required permissions for your Facebook App:

  1. From the App Review menu, select Permissions and Features.
  2. Locate the public_profile option and click Get Advanced Access.
    Configuring permissions
  3. Agree to the request and click Confirm.

3. Retrieve the App Credentials.

To retrieve the Facebook App credentials from your Facebook account:

  1. Go to the Facebook developer portal.
  2. From Settings, select Basic.
  3. Click Show to view the App ID and Secret.
    Viewing Facebook app credentials

4. Configure the App in WHMCS.

To enable sign-in integrations with the Facebook app 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 Facebook.
  4. Enter your credentials for Facebook App ID and Facebook App 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 Facebook API, the system will save them.

Common Errors

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

Error MessageDescriptionRecommended Solution
Invalid details not saved. Please verify your details and try again.You may receive the above error message when attempting to configure your Facebook API credentials. It indicates that the values are not able to successfully authenticate with the Facebook API.If you receive this message, check your API key and secret and try again.
Can't Load URL: The domain of this URL isn't included in the app's domains.If you see the following error message when attempting to sign in using Facebook, the URL in your Facebook app is no longer valid: Can't Load URL ErrorTry setting the URL in Facebook again.
App Not SetupIf you see the following error message when attempting to sign in using Facebook, your app is still in development mode and you need to set it to public mode: App Note Setup: This app is still in development mode, and you don't have access to it. Switch to a registered test user or ask an app admin for permissions.Check to ensure that your app permissions are correct.

Last modified: June 11, 2024