Loading
Salesforce now sends email only from verified domains. Read More
Automate Your Business Processes
Table of Contents
Filter by (0)Add
Select Filters

          No results
          No results
          Here are some search tips

          Check the spelling of your keywords.
          Use more general search terms.
          Select fewer filters to broaden your search.

            Search all of Salesforce Help
            Search all of Salesforce Help
            Connect to an External System

            You are here:

            1. Salesforce Help
            2. Docs
            3. Automate Your Business Processes

            Connect to an External System

            Create a connection to an external system in the Automation app.

            Required Editions

            Available in: Lightning Experience
            View supported editions.
            This feature requires the MuleSoft for Flow: Integration add-on. Professional Edition requires the API access add-on. To purchase, contact your Salesforce account executive.
            MuleSoft for Flow: Integration features used with Agentforce require the Foundations or Agentforce 1 edition. To purchase these editions, contact your Salesforce account executive.
            User Permissions Needed
            To create, view, edit, and delete MuleSoft for Flow: Integration connections: Manage Integration Connections
            To open, edit, create, activate or deactivate a flow using all flow types, elements, and features available in Flow Builder, including Einstein and Agentforce for Flow: Manage Flow
            To create and edit External System Change-Triggered flows in the Automation app, regardless of sharing settings:

            Manage Flow

            OR

            Create or Edit Flows

            AND

            • View Flows
            • View All Non-Admin Flows
            To create and edit External System Change-Triggered flows owned by or shared with you with Read/Write access in the Automation app:

            Create or Edit Flows

            AND

            View Flows
            To use MuleSoft for Flow: Integration templates:

            Create or Edit Flows

            OR

            View Flows
            To use MuleSoft for Flow: Integration templates as a non-System Admin: App Framework Manage Template
            Note
            Note You can edit or delete connections only in the Automation app.

            To make this app available to anyone with the permission to use it, select the Enable the Automation Lightning App process automation setting. To view connection version information, activate at least one connection.

            For an overview of how to set up MuleSoft for Flow: Integration and to create automated connections between systems, refer to Get Started with MuleSoft for Flow: Integration.

            Create a Connection to an External System by Using a Standard Authentication Method

            Create a connection to an external system by using the connector’s standard authentication method.

            1. Open the Automation app and select the Integrations tab.
            2. Choose a method to create a connection.
              • Select a third-party connector from the Get Started with Connectors section and then click Create Connection. If your connector isn’t available in the section, click View All Connectors, select a connector from the Browse Connectors window, and then click Next.
              • Click New Connection, select an available third-party connector, and then click Next.
            3. In Authentication Protocol, select a standard authentication method.
            4. Complete the connection information and authentication details for that connector.
              Important
              Important

              In the URL field, make sure that you enter the value in this format: http://<domain>. For example, https://thirdpartyconnector.com.

            5. Click Create.

            Connect to an External System by Using Named Credentials

            Select a named credential from Setup to use for your external system connections.

            Prerequisites

            Before connecting to your external system with a named credential, first create or use an existing authenticated named credential and external credential that is enabled for your users.

            To ensure a successful connection for use in a flow, use only one principal for each named credential.

            • Use the same name for the named credential and its related objects, such as the external credential and external authentication identity providers. Labels for these objects can differ.
            • Assign the user creating the connection the required user permission for the principal. Without this permission, the connection test fails and the connection remains inactive.
            Important
            Important

            When you create a connection with an existing named credential, note these behaviors:

            • Manage the named credential’s read-only details in Setup, not the Integrations tab. On the Integrations tab, you can only edit the connection's Connection Name and Description.
            • Perform reconnections for the named credential in Setup. The Reconnect button isn’t visible on the Details page.
            • Delete associated named credentials in Setup. Deleting a connection doesn't remove the credential.
            1. Open the Automation app and select the Integrations tab.
            2. Choose a method to create a connection.
              • Select a third-party connector from the Get Started with Connectors section and then click Create Connection. If your connector isn’t available in the section, click View All Connectors, select a connector from the Browse Connectors window, and then click Next.
              • Click New Connection, select an available third-party connector, and then click Next.
            3. In Authentication Protocol, select Named Credential, and then search for and select a named credential.
            4. Click Create.

            Refresh an OAuth 2.0 Connection

            If an expired refresh token interrupts a connection to an external system through OAuth 2.0 authentication, you can reconnect it.

            1. Select the connection to refresh.
            2. Click Reconnect.
            3. Complete the required steps to connect to the third-party system.
            4. Save your work.

              After refreshing the connection, the OAuth dance generates a new refresh token and reconnects the connection.

            Edit a Connection

            1. In the Automation app, on the Integrations tab, select the connection to edit.

              Flows that use the connection appear in the Flows Using Connection table on the Related tab. The table shows the name, version, status, and owner of each flow. To view a flow, click its name. For connection and authentication details, see the Details tab.

            2. Click Edit.
              Important
              Important

              Editing a connection in use by a flow can cause errors upon connection failure. Connection edits are permanent, take effect immediately, and impact all associated flows.

            3. Read the window, and click Edit.
            4. Edit the fields.
              Important
              Important You can’t edit disabled fields, such as Connection API Type and Authorization Type. If you edit a field in the Authentication Details section, the Password field clears. Enter the value again.
            5. Save your work.

              If errors appear after you save, the system doesn’t save your changes. Resolve the errors, and save again. A message indicates whether the connection test succeeded or failed. In the Integrations section, the Last Tested Date field and the Progress Status field in the Flows Using Connection table update to show your most recent test results.

            Test a Connection

            Opening or creating a flow that connects to an external system triggers a connection test and alerts you to any invalid connections. The system tests connections in these scenarios:

            • When you create the connection
            • When you select an existing connection to an external system to use as an action or a trigger
            • When you reopen an existing flow containing a connection to an external system

            You can also retest the connection manually.

            1. Select the connection that you want to test.
            2. Click Test.

              A message indicates the test result. In the Integrations section, in the Flows Using Connection table, the Last Tested Date and the Progress Status fields update with the latest test results.

            Delete a Connection

            1. Select the connection to delete.

              Flows that use the connection appear in the Flows Using Connection table on the Related tab. The table shows the name, version, status, and owner of each flow. To view a flow, click its name. For connection and authentication details, see the Details tab.

            2. Click Delete.
              Important
              Important

              You can’t delete a connection that a flow uses. To delete a connection, first remove it from all associated flows. Connection deletions are permanent.

            3. Read the window, and click Close.
              If your connection deletion is successful, a success message appears and you’re redirected to the Integrations tab. If the deletion fails, an error message appears.

            See Also

             
            Loading
            Salesforce Help | Article