BusyBot

Reference · Credentials

Mautic API credentials

Used by 2 BusyBot nodes.

Type mauticApi 3 fields

The Mautic credential uses basic authentication: your instance URL plus a Mautic username and password. Mautic ships with its API disabled, so the first step is enabling it — and basic authentication specifically — in the instance configuration.

Fields

FieldTypeRequiredNotes
URL
url		 string Yes The URL of your Mautic instance
Username
username		 string Yes Your Mautic login username.
Password
password		 password Yes Your Mautic login password.

Getting your credentials

  1. Sign in to your Mautic instance as an administrator.
  2. In the global configuration, open the API Settings and enable the API. Enable HTTP basic auth as well — it is off by default and this credential depends on it.
  3. Create or choose a Mautic user for the automation and note its username and password.
  4. In BusyBot, set URL to your Mautic instance’s base URL, and enter the username and password.

Permissions and scopes

The credential acts as that Mautic user, so its role determines what the workflow can read and change. Create a dedicated user with a role limited to the objects the workflow touches rather than reusing an administrator login.

Troubleshooting

  • 401 Unauthorized on correct credentials — the API or HTTP basic auth is still disabled in Mautic’s configuration.
  • 404 or connection refused — the URL is wrong, or the instance is not reachable from the workflow environment.
  • 403 on an action — the Mautic user’s role does not permit it.
  • Credentials sent in the clear — basic authentication is only encoded, so the instance must be served over HTTPS.

Frequently asked questions

Why does authentication fail even with the right password?

Mautic ships with its API disabled, and HTTP basic auth is a separate switch inside the API settings. Both must be enabled in the instance configuration.

Should I use an administrator account?

Better not to. Create a dedicated Mautic user with a role limited to the objects the workflow touches — the credential can do everything that user can.

Does the instance need HTTPS?

Yes, in practice. Basic authentication encodes rather than encrypts, so the password is effectively plaintext over an unencrypted connection.

Nodes that use Mautic API

One credential works across every node below — create it once and reuse it.

Last updated . Spotted something wrong? Tell us.