Change the connection in a flow or resource

A connection is the conduit that regulates the flow of data to and from the source and destination. When you query an app to export data from it or import data into it, that HTTP request is added to the connection’s queue and processed in order, after earlier requests.

Prior to integrator.io v6.11, released in November 2020, each flow step (such as an export, import, lookup, or download) could use only the connection you created or selected when you initially built that resource. You would have had to rebuild the step to apply a different connection. Now, you have more flexibility within a flow, including “global” changes for all of the steps that use a shared connection.

Deliberately applying connections and adjusting the concurrency levels among them gives you greater control over the volume of data that is requested. It’s the most powerful tool you have to optimize integration performance so that high-volume flows more quickly and high-priority records reach their destination first.

Contents

• Change the connection in a flow step
• Replace all connections throughout a flow

Caution: When you replace a connection, all jobs in progress will be canceled, including any jobs that happen to be currently queued to run, even if the actual processing has not yet started.

Change the connection in a flow step

Whenever you modify a flow step – via Flow Builder, or Resources > Exports or Imports, you have the opportunity to perform any of the following connection operations:

• Select an existing connection to the same endpoint (the drop-down list)
• Create a connection (the + button) – applied to the current resource and available throughout your account
• Edit an existing connection to the same endpoint (the   button)

In other words, the Connection setting – in an import, for example – works exactly the same in either the Create import or the Edit import pane.

For instructions on creating connections to applications using our app-specific or universal connectors, see the Help Center category Connector solutions.

Sample lookup (export) with editable connection

Replace all connections throughout a flow

This operation applies only to the flow steps that use the connection you’re replacing; other flow steps to the same endpoint (but different, discrete connection), as well as other endpoints in the flow, are unaffected.

Tip: Be sure to configure the new connection before you continue with the steps below.

1. Navigate to your integration and open a flow in Flow Builder.
2. In the Connections tab, find the row for a specific connection:
   1. Click its Actions overflow (...) menu.
   2. Select Replace connection from the drop-down list.

3. In the Replace connection pane, the Connection drop-down list contains all available connections for this endpoint. Choose a different connection from the list.

4. Click Replace.

The new connection applies to each flow step that had used the replaced connection.

All jobs in progress will be canceled, including any jobs that happen to be currently queued to run, even if the actual processing has not yet started.