# Matomo API Key / auth Token

In order to get the relevant information for your data you need to get some relevant data from your analytics tool, in this case from Matomo.

Before you get your Matomo authentification token note that the `token_auth` is secret and should be handled very carefully: do not share it with anyone. Each Matomo user has a different `token_auth`.

### Matomo 4 and newer

To generate a `token_auth` follow these steps:

* Log in to Matomo
* Go to the Matomo Admin through the top menu
* Click on Personal -> Security
* In the bottom of the page click on “Create new token”

![](/files/-Mkuylkmw7ajS8s3ID0z)

* Confirm your account password
* Enter the purpose for this plugin as a description

![](/files/-MkuyuuP7zxKJeIjns0A)

* Click on “Create new token”

You will now see the newly created token. Save it somewhere safe as you won’t be able to see it any more once you leave that screen. If you lose it, you will need to generate a new token.

We recommend you create a new token for Acona, in case you already have a token in place. That way you can manage them more easily. 

Add this token to the API Key Field when ading your data source in Acona.

![](/files/-Mkv-udIe4SkN-70K7rH)


---

# Agent Instructions: 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:

```
GET https://acolono.gitbook.io/acona/user-documentation/the-backend-system/matomo-auth-token.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.