Basic Authentication lets you connect to Mautic using your existing Mautic username and password. This is the default authentication method and the fastest way to get started.
Prerequisites
Before you can use Basic Authentication, you must enable it in your Mautic instance. Mautic does not enable HTTP Basic Auth by default.
- Log in to your Mautic instance as an administrator.
- Go to Settings (gear icon) > Configuration.
- Click the API Settings tab.
- Set API enabled? to Yes.
- Set Enable HTTP basic auth? to Yes.
- Click Save & Close.
If you skip this step, the plugin will not be able to connect and you will see authentication errors when testing the connection.
Setup Steps
- In WordPress, go to WooCommerce > Mautic Integration.
- On the Connection tab, enter your Mautic URL (for example,
https://your-mautic.com). Do not include a trailing slash. - Under Authentication Method, select Basic Authentication. This is the default selection.
- Enter your Mautic Username.
- Enter your Mautic Password.
- Click Save Changes.
Password Security
Your Mautic password is never stored in plain text. The plugin encrypts it at rest using AES-256-CBC encryption, with your WordPress AUTH_KEY and AUTH_SALT as the encryption key and salt. This means that even if someone gains access to your WordPress database, they cannot read the stored password without also having your site’s secret keys.
When you save settings, the password field appears blank with a placeholder showing dots. This is normal. Leave the password field empty if you want to keep the currently saved password. Only enter a new value when you need to change it.
Mautic URL Format
The Mautic URL should be the base URL of your Mautic installation. Here are some examples of correct and incorrect formats:
- Correct:
https://mautic.yoursite.com - Correct:
https://yoursite.com/mautic - Incorrect:
https://mautic.yoursite.com/(trailing slash) - Incorrect:
https://mautic.yoursite.com/api(do not include the API path)
The plugin automatically removes any trailing slash you enter, but it is good practice to enter the URL without one.
After Setup
Once you have saved your credentials, use the Test Connection button to verify that the plugin can reach your Mautic instance. See the Test Connection article for details on what to expect.