Contact Us 1-800-596-4880

MuleSoft Composer for Salesforce - Getting Started

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.

  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.
    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.

  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.

  • Your Anypoint organization doesn’t currently have a client app named “Composer”.

  • Your organization has Rest APIs 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.

  • The API must be accessible from the public internet.

  • The API must be published to a public portal.

For more information on how to connect externally available APIs, refer to Rest Consumer Connector.

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.

  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.
    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.