> For the complete documentation index, see [llms.txt](https://docs.n8n.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.n8n.io/integrations/builtin/credentials/mautic.md).

# Mautic credentials

You can use these credentials to authenticate the following nodes:

* [Mautic](/integrations/builtin/app-nodes/n8n-nodes-base.mautic.md)
* [Mautic Trigger](/integrations/builtin/trigger-nodes/n8n-nodes-base.mautictrigger.md)

## Supported authentication methods <a href="#supported-authentication-methods" id="supported-authentication-methods"></a>

* Basic auth
* OAuth2

## Related resources <a href="#related-resources" id="related-resources"></a>

Refer to [Mautic's API documentation](https://developer.mautic.org/#rest-api) for more information about the service.

## Using basic auth <a href="#using-basic-auth" id="using-basic-auth"></a>

{% hint style="info" %}
**API enabled**

To set up this credential, your Mautic instance must have the API enabled. Refer to [Enable the API](#enable-the-api) for instructions.
{% endhint %}

To configure this credential, you'll need an account on a [Mautic](https://www.mautic.org/) instance and:

* Your **URL**
* A **Username**
* A **Password**

To set it up:

1. In Mautic, go to **Configuration > API Settings**.
2. If **Enable HTTP basic auth?** is set to **No**, change it to **Yes** and save. Refer to the [API Settings documentation](https://docs.mautic.org/en/5.x/configuration/settings.html#api-settings) for more information.
3. In n8n, enter the Base **URL** of your Mautic instance.
4. Enter your Mautic **Username**.
5. Enter your Mautic **Password**.

## Using OAuth2 <a href="#using-oauth2" id="using-oauth2"></a>

{% hint style="info" %}
**API enabled**

To set up this credential, your Mautic instance must have the API enabled. Refer to [Enable the API](#enable-the-api) for instructions.
{% endhint %}

To configure this credential, you'll need an account on a [Mautic](https://www.mautic.org/) instance and:

* A **Client ID**: Generated when you create new API credentials.
* A **Client Secret**: Generated when you create new API credentials.
* Your **URL**

To set it up:

1. In Mautic, go to **Configuration > Settings**.
2. Select **API Credentials**.<br>

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>No API Credentials menu</strong></p><p>If you don't see the <strong>API Credentials</strong> option under <strong>Configuration > Settings</strong>, be sure to <a href="#enable-the-api">Enable the API</a>. If you've enabled the API and you still don't see the option, try <a href="https://forum.mautic.org/t/cant-find-api-credentials-menu/10689">manually clearing the cache</a>.</p></div>
3. Select the option to **Create new client**.
4. Select **OAuth 2** as the **Authorization Protocol**.
5. Enter a **Name** for your credential, like `n8n integration`.
6. In n8n, copy the **OAuth Callback URL** and enter it as the **Redirect URI** in Mautic.
7. Select **Apply**.
8. Copy the **Client ID** from Mautic and enter it in your n8n credential.
9. Copy the **Client Secret** from Mautic and enter it in your n8n credential.
10. Enter the Base **URL** of your Mautic instance.

Refer to [What is Mautic's API?](https://kb.mautic.org/article/what-is-mautic-039%3bs-api.html#mcetoc_1g7n1bgoo0) for more information.

## Enable the API <a href="#enable-the-api" id="enable-the-api"></a>

To enable the API in your Mautic instance:

1. Go to **Settings > Configuration**.
2. Select **API Settings**.
3. Set **API enabled?** to **Yes**.
4. **Save** your changes.

Refer to [How to use the Mautic API](https://kb.mautic.org/article/what-is-mautic-039;s-api.html) for more information.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.n8n.io/integrations/builtin/credentials/mautic.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.