After entering your Mautic credentials, you should test the connection to make sure everything is working. The Connection tab includes a built-in test that verifies the plugin can reach your Mautic instance and authenticate successfully.
How to Test
- Go to WooCommerce > Mautic Integration and open the Connection tab.
- Make sure you have entered your Mautic URL and credentials and clicked Save Changes.
- Scroll down to the Connection Test section.
- Click the Test Connection button.
- Wait a few seconds for the result to appear next to the button.
What Success Looks Like
When the connection is working, you will see a “Connected successfully!” message. The test also returns the total number of contacts in your Mautic instance, which confirms that the plugin can read data from the API.
What Failure Looks Like
If the test fails, you will see an error message describing what went wrong. Here are the most common errors and how to resolve them:
Connection Errors
- “Could not resolve host” – The Mautic URL is incorrect or the server cannot be reached. Double-check the URL you entered and make sure your Mautic instance is online.
- “Connection timed out” – The Mautic server did not respond within 30 seconds. This could be a temporary network issue or your Mautic server may be overloaded. Try again in a moment.
- “SSL certificate problem” – Your Mautic instance has an invalid or expired SSL certificate. Make sure your Mautic server has a valid HTTPS certificate installed.
Authentication Errors
- “HTTP 401” or “Unauthorized” – Your credentials are incorrect or have expired. For Basic Auth, verify your username and password. For OAuth2, try re-authorizing by clicking the Authorize button again.
- “HTTP 403” or “Forbidden” – Your Mautic user does not have permission to access the API. Make sure the user account has admin or API access in Mautic.
API Errors
- “HTTP 404” – The API endpoint was not found. This usually means the API is not enabled in Mautic. Go to Mautic Settings > Configuration > API Settings and enable the API.
- “HTTP 500” – An internal server error occurred on the Mautic side. Check your Mautic server logs for details.
How the Test Works
Behind the scenes, the Test Connection button sends an AJAX request from your browser to WordPress, which then makes an API call to your Mautic instance. Specifically, it requests a list of contacts with a limit of 1. If Mautic responds with valid data, the connection is confirmed. If Mautic returns an error, the error message is displayed.
Tips
- Always save your settings before testing. The test uses the saved credentials, not the values currently in the form fields.
- If you recently changed your Mautic password, enter the new password in the plugin settings and save before testing.
- If you continue to have issues, enable Debug Mode on the Connection tab to capture detailed logs that can help identify the problem.