Authenticated tokens are used to manage access to individual Marketing Cloud Engagement business units. Tokens are periodically refreshed to ensure a secure connection. If a token fails to refresh, you can manually reconnect the business unit.
Required Editions
| User Permissions Needed | |
|---|---|
| To refresh authentication: | DMAdministrator License permission set, Administrator permission (mcdm_15 namespace), Manage Auth Providers, Modify All Data, and Customize Application |
Tokens don’t typically fail to refresh with normal use, but they can fail if an authenticated call isn’t made for 30 days or more. Authenticated calls are made during any action in Distributed Marketing that pulls back information from the Marketing Cloud Engagement business unit. For example, selecting a Quick Send message to send. If a business unit becomes disconnected, you see an error on screen indicating that there’s a problem with your Marketing Cloud Engagement authentication.
To reconnect the business unit:
- Log out of all Marketing Cloud Engagement sessions.
- In Salesforce, from the App Launcher, find and open Distributed Marketing Administration.
-
In the Business Units section, select Update Connection Information.
The system checks the status of all added business units. If a business unit isn’t
authenticated, the system displays Complete Log In in the Connection Status column.
Note This update reports the status of the business unit connections and doesn’t change the business units connections. - Select Complete Log In. The system opens the associated named credential record.
- Select Edit.
- Ensure that Start Authentication Flow on Save is enabled.
- Save your work. The system prompts you to log into Marketing Cloud Engagement.
- Log into Marketing Cloud Engagement using your unique system user.
- To verify authentication status, navigate to Distributed Marketing Administration, and click Update Connection information.