{"id":341,"date":"2026-02-09T05:00:50","date_gmt":"2026-02-09T05:00:50","guid":{"rendered":"https:\/\/sitepact.com\/docs\/guide\/mautic-integration-for-woocommerce\/connection-authentication\/test-connection\/"},"modified":"2026-02-09T05:00:50","modified_gmt":"2026-02-09T05:00:50","slug":"test-connection","status":"publish","type":"docs","link":"https:\/\/sitepact.com\/docs\/guide\/mautic-integration-for-woocommerce\/connection-authentication\/test-connection\/","title":{"rendered":"Test Connection"},"content":{"rendered":"\n

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.<\/p>\n\n\n\n

How to Test<\/h2>\n\n\n\n
    \n
  1. Go to WooCommerce > Mautic Integration<\/strong> and open the Connection<\/strong> tab.<\/li>\n
  2. Make sure you have entered your Mautic URL and credentials and clicked Save Changes<\/strong>.<\/li>\n
  3. Scroll down to the Connection Test<\/strong> section.<\/li>\n
  4. Click the Test Connection<\/strong> button.<\/li>\n
  5. Wait a few seconds for the result to appear next to the button.<\/li>\n<\/ol>\n\n\n\n

    What Success Looks Like<\/h2>\n\n\n\n

    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.<\/p>\n\n\n\n

    What Failure Looks Like<\/h2>\n\n\n\n

    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:<\/p>\n\n\n\n

    Connection Errors<\/h3>\n\n\n\n
      \n
    • “Could not resolve host”<\/strong> – 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.<\/li>\n
    • “Connection timed out”<\/strong> – 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.<\/li>\n
    • “SSL certificate problem”<\/strong> – Your Mautic instance has an invalid or expired SSL certificate. Make sure your Mautic server has a valid HTTPS certificate installed.<\/li>\n<\/ul>\n\n\n\n

      Authentication Errors<\/h3>\n\n\n\n
        \n
      • “HTTP 401” or “Unauthorized”<\/strong> – 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.<\/li>\n
      • “HTTP 403” or “Forbidden”<\/strong> – Your Mautic user does not have permission to access the API. Make sure the user account has admin or API access in Mautic.<\/li>\n<\/ul>\n\n\n\n

        API Errors<\/h3>\n\n\n\n
          \n
        • “HTTP 404”<\/strong> – 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.<\/li>\n
        • “HTTP 500”<\/strong> – An internal server error occurred on the Mautic side. Check your Mautic server logs for details.<\/li>\n<\/ul>\n\n\n\n

          How the Test Works<\/h2>\n\n\n\n

          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.<\/p>\n\n\n\n

          Tips<\/h2>\n\n\n\n
            \n
          • Always save your settings before testing. The test uses the saved credentials, not the values currently in the form fields.<\/li>\n
          • If you recently changed your Mautic password, enter the new password in the plugin settings and save before testing.<\/li>\n
          • If you continue to have issues, enable Debug Mode<\/strong> on the Connection tab to capture detailed logs that can help identify the problem.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

            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 […]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":338,"menu_order":2,"comment_status":"","ping_status":"","template":"","format":"standard","categories":[],"doc_label":[],"doc_tag":[],"class_list":["post-341","docs","type-docs","status-publish","format-standard","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/sitepact.com\/docs\/wp-json\/wp\/v2\/docs\/341","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/sitepact.com\/docs\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/sitepact.com\/docs\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/sitepact.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/sitepact.com\/docs\/wp-json\/wp\/v2\/comments?post=341"}],"version-history":[{"count":0,"href":"https:\/\/sitepact.com\/docs\/wp-json\/wp\/v2\/docs\/341\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/sitepact.com\/docs\/wp-json\/wp\/v2\/docs\/338"}],"wp:attachment":[{"href":"https:\/\/sitepact.com\/docs\/wp-json\/wp\/v2\/media?parent=341"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sitepact.com\/docs\/wp-json\/wp\/v2\/categories?post=341"},{"taxonomy":"doc_label","embeddable":true,"href":"https:\/\/sitepact.com\/docs\/wp-json\/wp\/v2\/doc_label?post=341"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/sitepact.com\/docs\/wp-json\/wp\/v2\/doc_tag?post=341"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}