> 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/mattermost.md).

# Mattermost credentials

You can use these credentials to authenticate the following nodes:

* [Mattermost](/integrations/builtin/app-nodes/n8n-nodes-base.mattermost.md)

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

* API access token

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

Refer to [Mattermost's API documentation](https://api.mattermost.com/) for more information about the service.

## Using API access token <a href="#using-api-access-token" id="using-api-access-token"></a>

To configure this credential, you'll need a [Mattermost](https://www.mattermost.com/) account and:

* A personal **Access Token**
* Your Mattermost **Base URL**.

To set it up:

1. In Mattermost, go to **Profile > Security > Personal Access Tokens**.<br>

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>No Personal Access Tokens option</strong></p><p>If you don't see the Personal Access Tokens option, refer to the troubleshooting steps in <a href="#enable-personal-access-tokens">Enable personal access tokens</a> below.</p></div>
2. Select **Create Token**.
3. Enter a **Token description**, like `n8n integration`.
4. Select **Save**.
5. Copy the **Token ID** and enter it as the **Access Token** in your n8n credential.
6. Enter your Mattermost URL as the **Base URL**.
7. By default, n8n connects only if SSL certificate validation succeeds. To connect even if SSL certificate validation fails, turn on **Ignore SSL Issues**.

Refer to the Mattermost [Personal access tokens documentation](https://developers.mattermost.com/integrate/reference/personal-access-token/) for more information.

## Enable personal access tokens <a href="#enable-personal-access-tokens" id="enable-personal-access-tokens"></a>

Not seeing the **Personal Access Tokens** option has two possible causes:

* Mattermost doesn't have the personal access tokens integration enabled.
* You're trying to generate a personal access token as a non-admin user who doesn't have permission to generate personal access tokens.

To identify the root cause and resolve it:

1. Log in to Mattermost as an admin.
2. Go to **System Console > Integrations > Integration Management**.
3. Confirm that **Enable personal access tokens** is set to **true**. If it's not, change.
4. Go to **System Console > User Management > Users**.
5. Search for the user account you want to allow to generate personal access tokens.
6. Select the **Actions** dropdown for the user and select **Manage roles**.
7. Check the box for **Allow this account to generate personal access tokens** and **Save**.

Refer to the Mattermost [Personal access tokens documentation](https://developers.mattermost.com/integrate/reference/personal-access-token/) for more information.