---
schema_version: "1"
id: 1f7b1f03734cc826acb114028c6526583457b74050119ff5b60b607ba53a5d65
title: Connecting to Salesforce
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/api-experience-hub/connecting-to-salesforce.md
canonical_url: https://docs.mulesoft.com/api-experience-hub/connecting-to-salesforce
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 28d6908c938e211baa9cc7dba090ddeb0eaf34219d977f4f70da566721b65498
description: MuleSoft Documentation Site
latest: true
---
---
product: API Experience Hub
---

# Connecting to Salesforce

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

API Experience Hub contains a Salesforce organization with Experience Cloud and a managed package.
The managed package is installed during the onboarding process. The API Experience Hub administrator
or a Salesforce user with the System Administrator profile or
[AEH\_Anypoint permission set](https://docs.mulesoft.com/api-experience-hub/user-roles-permissions-and-profiles) connects the Salesforce
organization to the Anypoint Platform organization. The managed package contains the components and
data objects that interact with your Anypoint Platform organization. The Salesforce System
Administrator can view the **API Experience Hub** package in the Salesforce organization from
Salesforce by navigating to **Setup** > **Installed Packages** and selecting the **API Experience
Hub Package**.

A connection with Salesforce Experience Cloud is required for linking to the Salesforce organization
to create a portal within Anypoint Platform. This process must be completed only once to create a
portal. Currently, an instance of API Experience Hub can connect only to one Anypoint Platform
organization and one Salesforce organization.

When the connection is established, changing the connection doesn’t impact the connection between
the Salesforce organization and Anypoint Platform. Switching between production and sandbox
environments also doesn’t affect the connection. The portal remains operational.

## Connected App

API Experience Hub uses a connected app to obtain a session token in Anypoint Platform and interacts
with Salesforce APIs.

To view the connected app that is created in the Salesforce organization:

1.  From Salesforce, click **Setup**.

2.  In the **Quick Find** box, enter **app management** and click **App Manager**.

    The connected App (Anypoint\_AEH) is listed in the table.

In this release, IP restrictions for the connected app aren’t supported. The connected app bypasses
any trusted IP ranges in your organization. Don’t change this option because it produces errors when
creating the portal. For more information, see [Troubleshooting](https://docs.mulesoft.com/api-experience-hub/troubleshooting).

## Allow Access

To complete the connection process, allow API Experience Hub to access the following:

- Access the identity URL service

- Manage user data via Web browsers

- Manage user data via APIs

- Perform requests at any time

## Admin Teams

An API Experience Hub Admin team and an API Experience Hub Portal Admin team are created during the
connecting and linking process. Once your Salesforce organization is successfully connected to your
Anypoint Platform organization, the AEH Admin team is created. After the Salesforce linking process
is complete, any user who is assigned the AEH Admin role is automatically added to the AEH Admin
team.

After your styling changes for the portal are saved, the AEH Portal Admin team is created. Although
the API Experience Hub Portal Administrator team is visible in Access Management, this permission
isn’t supported in this release.

## Before You Begin Connecting to Salesforce

- Read the instructions in
  [Getting Started with API Experience Hub](https://docs.mulesoft.com/api-experience-hub/getting-started-with-api-experience-hub).

- Ensure that you’re a System Administrator or have the AEH\_Anypoint permission set in the
  Salesforce organization that you’re connecting with.

## Connect to Salesforce

The connecting process is a one-time step when creating your portal.

> [!NOTE] Only an Organization Administrator, API Experience Hub Administrator, or a Salesforce user
> with the System Administrator profile or AEH\_Anypoint permission set can connect to Salesforce to
> link organizations.

Follow these steps to connect to your Salesforce organization:

1.  Navigate to Anypoint Platform, enter your username and password, and then click **Sign in**.

2.  From Anypoint Platform, select **API Experience Hub**.

3.  From the **Welcome to API Experience Hub** page, if this is the first time connecting to
    Salesforce, click **Let’s Start**.

4.  Click **Connect to Salesforce**.

5.  To create a portal directly in production, select **Production** from the **Environment** list.

6.  To create a portal in a sandbox, select **Sandbox** from the **Environment** list.

7.  Enter the username and password of your Salesforce organization and click **Log In**.

8.  If you have a custom Salesforce domain, select **I have a custom Salesforce domain** and enter
    your domain address.

    If you don’t use a custom domain and you have active Salesforce sessions in the selected
    environment, you log in to Salesforce using the first active session.

9.  Click **Connect**.

10. Click **Allow** for MuleSoft to access your data.

11. To go back and connect to a different Salesforce organization, click **Connect with another
    Salesforce organization**.

    The process of connecting to a Salesforce organization restarts.

12. Confirm the Salesforce access information and click **Confirm connection**.

    The process of connecting to Salesforce and installing the Salesforce Experience Cloud package
    begins. When the package is installed successfully, you receive an email.

## Next Steps

When the connection to the Salesforce organization is complete, set up the portal. For more
information, see [Setting Up the Portal](https://docs.mulesoft.com/api-experience-hub/setting-up-the-api-portal).

## See Also

- [User Roles, Permissions, and Profiles](https://docs.mulesoft.com/api-experience-hub/user-roles-permissions-and-profiles)

- [Assigning Permissions](https://docs.mulesoft.com/api-experience-hub/assigning-permissions)

- [Working With Sandboxes](https://docs.mulesoft.com/api-experience-hub/working-with-sandboxes)

- [Troubleshooting](https://docs.mulesoft.com/api-experience-hub/troubleshooting)
