--- schema_version: "1" id: 4f450a8df2ed1c89e5b83ced8a99863bb415a3608a32198d5eba31e3b7babce0 title: MuleSoft Composer for Salesforce - Getting Started collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/composer-salesforce/ms_composer_prerequisites.md canonical_url: https://docs.mulesoft.com/composer-salesforce/ms_composer_prerequisites source_site: docs.mulesoft.com content_type: documentation content_hash: 8d4c63e452f414f207f046df0f2ab4c3ed0a86faab1b7cfe448a42f96c4fb29f description: MuleSoft Documentation Site latest: true --- --- product: Composer for Salesforce --- # MuleSoft Composer for Salesforce - Getting Started > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Check that you meet the listed requirements before you set up Composer. Then you can set up and begin using Composer. ## Requirements and Restrictions - The org where you set up Composer must be a Salesforce Unlimited, Enterprise, or Performance edition. It can’t be a sandbox org. - The maximum number of concurrent users supported by an organization is 25. - The org must have Lightning enabled. - You must purchase a separate MuleSoft Composer license for the org. - If your company network has a stringent firewall or list of blocked IP addresses, your network administrator must add `*.mulesoft.com` to the list of allowed addresses. IP addresses used by Composer are dynamic, therefore MuleSoft can’t provide a list of IP addresses. - You must relax any IP restrictions for the connections that you create to data sources and data targets. Instructions are included in the setup section of this topic. - Composer does not currently support mobile platforms. ### Browser Requirements - Don’t use incognito mode or private browsers to access Composer. - Composer uses Salesforce Canvas and therefore has the same browser requirements as Canvas. For Safari browsers, this means you must uncheck the **Prevent cross-site tracking** option in Safari security preferences. - When using Firefox or Chrome, you must allow third-party cookies. - When you create a connection to another system, check for the requirements and limitations listed in the Composer reference section for each connection. - Composer fields with date values use the following format: YYYY-MM-DDThh:mmZ. ## Available Regions In MuleSoft Composer for Salesforce, the Anypoint Platform control and runtime planes for an organization are pre-selected based on the data center in which the pod of the Salesforce instance is located. The mapping is done internally and users cannot change the mapping. All US and APAC pods use US East (N. Virginia) and all EU pods use EU (Frankfurt). ## Set Up Composer Before anyone can use Composer, a Salesforce admin must set it up, including installation, permissions assignments, and a few adjustments to your Salesforce org settings. ### Find the Composer Setup Page 1. Log in to your Salesforce org as an admin with the `System Administrator` profile. Do not use cloned or adjusted profiles even if they have more privileges. 2. Click the Setup gear icon, and then choose **Setup**. 3. Enter `composer` in the search bar. 4. Select **MuleSoft Composer** from the search results. If you can’t find Composer in the search results, it’s likely that your org needs to purchase a license for Composer. Next, you’ll install Composer and make some Salesforce org adjustments to ensure Composer works properly. ### Admin: Adjust the Session Settings 1. In the Salesforce Composer sidebar, click **Settings** > **Security** > **Session Settings**. 2. On the **Sessions Settings** page, in the **Session Settings** subsection, deselect the **Lock sessions to the IP address from which they originated** checkbox. 3. Click **Save**. ### Admin: Install Composer and Adjust Salesforce Org Settings 1. In the **Install the Managed Package for MuleSoft Composer** section, click **Install Managed Package**. Four more steps are revealed when the installation is complete. As the admin performing the installation, you are automatically given the Composer permission set. 2. In the **Change the Type of Permitted Users** section, click **Open Settings** to launch the Salesforce connected app page for Composer and change two settings: 1. In the **Permitted Users** dropdown, select **Admin approved users are pre-authorized**. 2. In the **IP Relaxation** dropdown, select **Relax IP restrictions**. 3. Save the changes. 3. In the **Configure MuleSoft Services** section, click **Initiate Configuration**. Salesforce certificates expire after one year. To renew an expired certificate, click **Initiate Configuration**. MuleSoft creates and configures an instance of Anypoint Platform to provide a dedicated environment for Composer. When MuleSoft creates and configures an instance of Anypoint Platform, MuleSoft automatically chooses the region when provisioning the org based on the pod of the Salesforce instance. For more information, refer to [Available Regions](#available-regions-sf). 4. In the **Assign Users to MuleSoft Composer** section, click the **Assign Users** button to go directly to the Salesforce **Permission Sets** page: 1. Click **Composer User** or **Composer Administrator**. 1. **Composer User** has general access to Composer functionality such as building and managing flows. 2. **Composer Administrator** has access to the **Settings** page and can manage email preferences and API Sharing. 2. Click **Manage Assignments**, and then **Add Assignments**. 3. Select the checkbox next to each user who will receive permission to use Composer. 4. Click **Add**. You can assign or revoke this permission set at any time. 5. In the **Launch MuleSoft Composer** section, click the **Launch** button to start Composer. Now that Composer is configured properly, you can launch it by searching for "composer" in the App Launcher. You can sync data between two Salesforce organizations with a single license. When you set up Composer, you can choose the primary organization in which you want to build flows and then, within Composer in that organization, you can create connections to one or more other Salesforce organizations. ## Users: Verify Access to Composer If you aren’t the Salesforce admin who installed Composer, verify that you have access to the Composer app: 1. In your Salesforce org, open the App Launcher. 2. Enter `composer` in the search bar. 3. Select **MuleSoft Composer** from the search results. If you don’t see **MuleSoft Composer** in the search results, it’s likely that you need to purchase Composer for your Salesforce org or that you don’t have permission to access it. When the Composer page displays, you’re ready to create your first flow. If you’d like to learn more before using Composer, review the other topics in this section. ## Enable Flow Failure Notifications As administrator, you can enable flow failure notifications via email. When enabled, checks run every 15 minutes on running flows. If any flow fails, Composer sends an email to the owner of the flow. Note that: - A maximum of four consecutive emails are sent for the same error. - The error log for the flow resets every 24 hours. - The error log only runs while the flow runs. To enable email notifications: 1. In the Composer **Home** page, click **Settings**. The **Account** page appears. 2. In the sidebar, click **Email Notifications**. 3. In the **Receive email notifications when flows fail to run** row, toggle the button to enable email notifications. ## Connect Composer to Anypoint Platform Organizations that use both MuleSoft Composer for Salesforce and Anypoint Platform can connect the two products. To link MuleSoft Composer for Salesforce to Anypoint Platform: 1. In MuleSoft Composer for Salesforce, at the top of the page, click **Settings**. 2. In the **Account** section, copy the value in the **Organization ID** field. 3. Log in to the Anypoint Platform organization that you want to connect to MuleSoft Composer for Salesforce. The **Anypoint Platform** page appears. 4. In the navigation pane, click [**Access Management**](https://docs.mulesoft.com/access-management/managing-your-account). The **Access Management** page appears. 5. In the **Access Management** page, in the navigation pane, click **Composer Sync**. If the **Composer Sync** button is not available, first click **Try New Features** to enable the button. The **Add Composer Organization** window appears. 6. In the **Add Composer Organization** window, in the **Organization ID** field, paste the **Organization ID** that you copied from the **Account** page of MuleSoft Composer for Salesforce and then click **Add**. 7. Open MuleSoft Composer for Salesforce and refresh the page. 8. In MuleSoft Composer for Salesforce, in the navigation pane, click **Settings** > **Account**. The **Account** page appears, displaying a linking request from Anypoint Platform. 9. Click **Review and Confirm**. 10. In the **Access Token** section, click **Authenticate in Anypoint**. The Anypoint Platform login page appears. 11. Log in to Anypoint Platform. Ensure that the user logging into Anypoint Platform has the right [permissions to create a client app](https://docs.mulesoft.com/api-manager/latest/access-client-app-id-task). 12. In the **Client App** section, click **Create Client App**. The Composer organization is now linked to the Anypoint organization. ## API Sharing MuleSoft Anypoint Platform customers can share externally available APIs managed in Anypoint Platform with business users for consumption in a MuleSoft Composer for Salesforce flow. Before sharing APIs from Anypoint Platform to MuleSoft Composer for Salesforce, ensure that: - Your organization uses Anypoint Platform for API Management. - Your Anypoint organization doesn’t employ [external client providers](https://docs.mulesoft.com/api-manager/latest/configure-multiple-credential-providers#how-using-multiple-external-client-providers-works). - Your Anypoint organization doesn’t currently have a client app named “Composer”. - Your organization has [Rest APIs](https://docs.mulesoft.com/exchange/to-create-an-asset#create-an-api-asset) managed by API Manager that conform to the following: - The API specifications use either RAML or OpenAPI. - The API uses basic authentication, bearer token, or API Key in conjunction with a Client ID and Secret. - The API has a value for the **Consumer Endpoint** field in API Manager. - Composer organizations are [linked to Anypoint organizations](#connect-composer-to-anypoint-platform). - The API must be accessible from the public internet. - The API must be published to a [public portal](https://docs.mulesoft.com/exchange/to-share-api-asset-to-portal). For more information on how to connect externally available APIs, refer to [Rest Consumer Connector](https://docs.mulesoft.com/composer-salesforce/ms_composer_rest_consumer_reference). ### Share an API Instance with Composer If you manage your APIs with Anypoint API Manager, you can share those APIs with MuleSoft Composer for Salesforce. To share an API Instance with MuleSoft Composer for Salesforce: 1. [Create an API Instance in Anypoint Platform](https://docs.mulesoft.com/api-manager/latest/api-instance-landing-page). 2. In Anypoint Platform, in the navigation pane, click **Exchange**. 3. In the list, find the API instance that you want to share, click **Request access**, and then click the Client App that was created by MuleSoft Composer for Salesforce. The **Request access** window appears. 4. In the **Request access** window, click **Request access**. 5. Open MuleSoft Composer for Salesforce and then open the flow to ensure that the shared API appears in the **Shared Apps** section of the canvas. ### Disconnect Composer Connection to Anypoint Platform You can disconnect your connection from MuleSoft Composer for Salesforce to Anypoint Platform; however, removing this connection does not delete existing configurations. To disconnect your MuleSoft Composer for Salesforce connection to Anypoint Platform: 1. Log in to the Anypoint Platform organization containing the connection to MuleSoft Composer for Salesforce that you want to disconnect. The **Anypoint Platform** page appears. 2. In the navigation pane, click [**Access Management**](https://docs.mulesoft.com/access-management/managing-your-account). The **Access Management** page appears. 3. In the navigation pane, click **Connected Apps**. The **Connected Apps** page appears. 4. Optionally, on the **Connected Apps** page, if you want to remove Composer’s access to a single API, click the options button for the API and then click **Remove**. 5. In the **Owned Apps** tab, next to **Composer API Sharing**, click the options button, and then click **Delete**. MuleSoft Composer for Salesforce is now disconnected from Anypoint Platform. ## Related Resources - [Overview](https://docs.mulesoft.com/composer-salesforce/ms_composer_overview) - [Composer Connector Reference](https://docs.mulesoft.com/composer-salesforce/ms_composer_reference) - [Knowledge Articles](https://help.salesforce.com/s/) - [Salesforce Canvas browser support](https://developer.salesforce.com/docs/atlas.en-us.platform_connect.meta/platform_connect/canvas_framework_supported_browsers.htm)