General: API credentials - Magento 2

Multiple Environments

A separate set of credentials should be used for your live and staging sites.


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

Entering your API credentials

  1. Log in to your Dotdigital account and open settings menu in the lower-left corner.
  2. Select Access > API users, and create a new API user.
  3. Return to your Magento admin panel and go to STORES > Configuration > Dotdigital > Accounts

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

    Note: Make sure that you enter your credentials correctly.
  5. Select 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 Dotdigital:
    Ensure that the user is enabled before continuing.

After saving the API credentials, the 'Enabled' drop-down 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.

Did you find this article helpful?

Can we help?

Thanks for using Dotdigital. If you need more help or support, then contact our support team.