Adding and Managing a Dotdigital Connection

When users create a Dotdigital profile for Messaging Recommendations, they need to have a Dotdigital API username and password. Those Dotdigital credentials are used by the Athos Commerce console to upload each customer's profile to the Dotdigital EasyEditor for use in their email campaigns.

Note: Do not use your personal Dotdigital credentials; be sure to add/configure a new API user for this purpose and provide Athos with those credentials instead.

Configuring Dotdigital API Credentials in the Console

When you are ready to configure your Dotdigital credentials, log into the Athos console and navigate to Data\Data Connectors\External Authorizations.

Click the "Add New +" button in the top right to create a new connection. A new window will open, where you will select the type of connection you'd like to add. Click the "Continue" button at the bottom right to proceed.

A new window will open, where you will configure your API credentials and the website(s) to include.

API Credentials

Username

Key in the username configured for Dotdigital API.

Password

Key in the password configured for Dotdigital API.

Filter

Click the Filter drop-down menu to select the website(s) to include. You can include multiple websites, but it is not required. Once you have selected a website, it will display below the filter drop-down menu.

Discard button

Click the Discard button at the bottom of the form to cancel the creation of this connection.

Authorize button

Click the Authorize button to save your changes and continue to validation at Dotdigital.

Creating Dotdigital API Credentials

If you do not have API credentials for Dotdigital, you can create them as follows:

1. Log in to Dotdigital here with your regular login credentials.
2. Drill down to the User menu in the bottom left, then select Settings/Access/API users.
3. Select NEW USER.

Note: The username will be generated automatically based on your email address.

4. Create a password.
5. For Status, select "Enabled".
6. Select SAVE.

Note: The API is only accessible with your API user credentials; however, you may have more than one API user per Dotdigital account.

Click here to see more detailed instructions from Dotdigital.

Managing the connection in Dotdigital

Once your Athos console is connected, log into Dotdigital. From the home page, mouse over your name at the bottom left and click "Settings".

Click "Access".

Click "API Users" at the top.

Click the "Edit" button for the selected user on the right-hand side, or click the "Add New API User" button at the top left.

If you choose to add a new user, the following window will appear:

Type in the user's description, password, and configure the rate limit and status, then click the "Save" button. You will be returned to the API Users page.