Connect Matomo (WP-Matomo, WP-Piwik) : Unable to link to matomo instance - Token passed with GET instead of POST?

General questions
1

Hello,

I’m installing the plugin to link my .matomo.cloud instance to my WordPress site. However, it fails when trying to create the link between the two. I’ve correctly created an API key with a Superadmin user, selected the correct link type (.matomo.cloud), and registered the subdomain.

It seems the WP-Matomo plugin (Matomo Cloud mode) is failing to connect because the token_auth is rejected by the Matomo Cloud API. The API explicitly returns the error: “Unable to authenticate with the provided token. It is either invalid, expired, or is required to be sent as a POST parameter.”

The plugin sends the token_auth in the URL (query string) via API.getBulkRequest, while Matomo Cloud requires the token to be passed as a POST parameter. This behavior results in a consistent HTTP 403 error before the API methods are even executed, even for simple calls like API.getPiwikVersion.

Could this be the cause of the error?

2

Hi there,

I’ve seen a small number of cases where the outgoing IP address of the WordPress server was blocked at the Matomo Cloud WAF level. When that happens, the Connect Matomo plugin is unable to establish a connection to the Cloud account and displays an error similar too "WP-Matomo 1.0.30 was not able to connect to Matomo using your configuration. Check the »Connect to Matomo”

If you can, reach out to the Cloud team at support@matomo.cloud and include your Matomo Cloud subdomain. They can then check whether an IP is being mistakenly blocked and unblock it if needed.