General: API credentials


To enable the dotmailer for Magento connector to communicate with your dotmailer account and allow data synchronisation, you will need to enter valid dotmailer API credentials.

Entering your API credentials

  1. Log in to your dotmailer account and mouse over the person-and-cog icon in the top-right corner. A settings menu appears; click Access > API users, and create a new API user.
  2. Return to your Magento admin panel and go to STORES > Configuration > DOTMAILER > API Credentials

  3. Enter the credentials (username and password) of the API user you just created.

    Note: Make sure that you enter your credentials correctly.
  4. Click Save Config. A confirmation message will tell you that the credentials are valid and that the configuration has been saved.


Why are my API credentials showing as red and not working?

  • You may not be entering the correct API credentials:
    Double-check the API credentials you're using are correct, and that you've entered them without a mistake. If, after double-checking, the problem persists despite the fact that you think you're using the correct details, we'd recommend deleting the API user and creating a new one just to make absolutely sure.
  • The API user may not be enabled within dotmailer:
    Ensure that the user is enabled before continuing.

After saving the API credentials, the 'Enabled' dropdown displays as 'No' and the details aren't saved. Why is this?

Sometimes the Magento admin panel caches previous details and is unable to save new ones. It which case, it is worth opening the Magento admin panel in a new session/browser and trying again.


Have more questions? Submit a request