---
schema_version: "1"
id: de34ca5ace88ebdf48b594745b722788f1a9843cfa08ed8392103c1c04c251ff
title: Upgrade to Connected App
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/mktg/264-0-0/mc_co_upgrade_to_connected_app_authentication.md
canonical_url: https://help.salesforce.com/s/articleView?id=mktg.mc_co_upgrade_to_connected_app_authentication.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 446526bf7b1ee5f9f9234cbe153d7dc37d77a52c5ed6a1e7517ff986fb515670
description: Upgrade your account to use Connected App Authentication, which is required for all Marketing Cloud Connect for Marketing Cloud Engagement accounts as of June 1, 2016.
products:
  - Marketing
  - Cross Cloud
release: "264"
---
# Upgrade to Connected App

Upgrade your account to use Connected App Authentication, which is required for all Marketing Cloud Connect for Marketing Cloud Engagement accounts as of June 1, 2016.

If "My Documents in Content" is enabled for your account, view migration details in files named with the date and migrationsuccess.csv or migrationfailures.csv.

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-mktg-mc_cross-cloud_products-264-0-0-production-enus/bd617332-480f-48e8-b283-3477883c1320/images/icon_important.png)

Important

Schedule a 2-hour sending outage for the upgrade. The connection between the Sales, Service, and Marketing Cloud Engagement isn’t available during the upgrade process, so ensure that all Marketing Cloud Connect activities are paused. All sends to reports, campaigns, contacts, leads, and Salesforce data extensions fail. Marketing Cloud Engagement sends that do not involve Marketing Cloud Connect aren’t affected.

The Engagement admin completes steps 1–11. The Sales or Service Cloud admin completes the remaining steps.

1. In the Marketing Cloud, navigate to **Email Studio**.
2. Click **Admin**.
3. Click **Salesforce Integration**.
4. Click **Upgrade to Connected App**.
    
    ![Warning](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-mktg-mc_cross-cloud_products-264-0-0-production-enus/bd617332-480f-48e8-b283-3477883c1320/images/icon_warning.png)
    
    Warning During this process, the system automatically connects to any active Salesforce session. To prevent incorrect connection, log out of any active Sales or Service Cloud sessions, other than the Salesforce system user session for this process. Closing the tab doesn’t end an active session.
    
    If you are using a company-specific login URL, such as https://mycompany.my.salesforce.com, log in to the org that you’re connecting to using the Salesforce system user credentials before connecting your accounts.
5. Click **Connect Account**.
6. Acknowledge the changes to your account and begin the upgrade process.
7. Log in to your Sales or Service Cloud org using the Salesforce system user credentials if prompted.
8. Allow the Salesforce Marketing Cloud Connected App to access your data if prompted.
9. Select **Migrate Existing Users** to automatically reconnect any previously connected users, if available. Auto-connection is available for 14 days after the upgrade.
10. To begin the auto-connection process, click **Connect**.
11. To close the auto-connection results popup window, click **OK**.
12. In the Sales or Service cloud, click **Setup**.
13. Search for **Connected Apps** in the Quick Find box and click **Connected Apps**.
14. Click **Salesforce Marketing Cloud**.
15. Click **Edit**.
16. Under Permitted Users, select **Admin approved users are pre-authorized**.
17. Under IP Relaxation, select **Relax IP restrictions**.
18. Under Refresh Token Policy, select **Immediately expire refresh token**.
19. Click **Save**.
20. From Setup, search for **Permission Sets** in the Quick Find box and click **Permission Sets**.
21. Create a new permission set.
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-mktg-mc_cross-cloud_products-264-0-0-production-enus/bd617332-480f-48e8-b283-3477883c1320/images/icon_note.png)
    
    Note This permission set is used to associate users to the Salesforce Marketing Cloud Connected App and can remain empty.
22. Name the permission set, for example, **Marketing Cloud Connected App**.
23. Validate the auto-generated API, which is generated using the permission set name.
24. Save the changes.
25. Click the name of the newly created permission set.
26. Click **Manage Assignments**.
27. Click **Add Assignments**.
28. Select the users who need access to the Connected App, typically all users with access to Marketing Cloud Connect.
29. Click **Assign**.
30. Click **Done**.
31. From Setup, search for **Connected Apps** in the Quick Find box and click **Connected Apps**.
32. Click **Salesforce Marketing Cloud**.
33. Click **Manage Permission Sets**.
34. Select the newly created permission set.
35. Click **Save**.

The Connected App authentication upgrade is complete. Send a test email to yourself to validate the connection and monitor your API usage.

#### See Also

- [Connected Apps](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_overview.htm&language=en_US)