Mobile App: Troubleshooting

From WHMCS Documentation

Revision as of 09:07, 24 June 2020 by John (talk | contribs)

Connection and Access

You must configure an API Access Key to use WHMCS Mobile

This error indicates that you didn't add the API Access Key to the configuration.php file successfully. Please ensure you've added the API Access Key to your configuration.php file and then enter that value in the Access Key field into the WHMCS Mobile app.

Step-by-step instructions are located at Mobile_App:_Connecting_to_WHMCS

Invalid special character in Access Key

Don't use the following special characters in your access key & " ' < > (ampersand, double quotes, single quotes, less than or greater than). Acceptable special characters are:



! @ # $ % . ( ) * [ ] - _


Access Denied

Our mobile app uses the API to communicate with your WHMCS installation. The Administrator Roles of staff using the app will require the "API Access" permission.

To grant this permission:

  1. Navigate to Setup > Staff Management > Administrator Roles
  2. Edit the role to which your staff member belongs
  3. Tick the API Access checkbox
  4. Click Save Changes

Unable to connect. Please check the installation and device are online and try again

Please ensure that you are entering the URL as "https://whmcs.yourdomain.com/" or "https://yourdomain.com/whmcs/ with the trailing slash at the end.

The WHMCS URL should be the URL to the frontend (client area) also the same as the System URL found in Setup > General Settings > General within the admin area.

Authentication Failed

Authentication Failed indicates that the admin user name or password supplied in the profile are being rejected. Type your username and password again to make sure that they are correct.