Replace connections across multiple modules
In Make, you may occasionally need to replace a connection that's used in multiple modules of the same app across one or many scenarios. This might be necessary when:
- You've switched accounts.
- The authentication method has been changed.
- You need to replace the connection instead of editing the credentials for an existing one.
Instead of replacing each connection manually, you can choose one of the two methods, depending on where the connection is used:
Replace the connection within one scenario
Use this method when multiple modules in the same scenario use the connection you want to replace.
You'll need the Make DevTool installed. See the installation instructions here.
Open the scenario in Make where you want to change the connection.
Click any module that will use the new connection, then click Add next to the Connection field.
Complete the required steps to create and save your new connection.
Open Chrome Developer Tools:
- Windows: Control+Shift+I or F12
- Mac: Fn+F12
Use a horizontal dock for better visibility. Click the three dots in the toolbar's right corner to configure this.
Switch to the Make tab in the Developer Tools.
In the left sidebar, click Tools, then select Swap Connection.
In the Source Module field, select the module where you’ve created the new connection. The number in brackets helps you locate it in the Scenario Builder.
In the Target Module field, add the modules where you want to change the connection. Leave it empty to update all the modules of the same app in the scenario.
Click Run.
Wait for the “Run completed” message, and click Done.
All modules from the app in this scenario now use the new connection.
Replace connections within multiple scenarios
If you need to update the connection used in multiple scenarios, using Make DevTool may be time-consuming. Instead, you can use Make app modules to replace connections across multiple scenarios. For that, you need to:
The Make app is only available on paid plans.
Obtain the IDs of the old and new connections
To change the connection across multiple scenarios, you'll first need to obtain the IDs of both the old and new connections.
Before you begin, make sure you’ve already created the new connection in at least one scenario. If not, follow these steps to create a new connection, then return here to continue.
Log in to your Make account and click + Create new scenario.
Add the Make app and select the List connections in a team module.
Configure the module settings:
- In the Connection field, choose your Make connection. If you use an API connection, make sure your API key has the organizations:read and connections:read scopes.
- In the Team ID field, click Search teams, and select the required team.
- Optional: In the Type field, you can enter the app name, if you know the exact one:
- The app name is typically the name of the service (e.g., shopify, notion, facebook).
- If the app offers more than one connection type, the name may have a number appended (e.g., slack2, airtable3).
- For apps with compound names, dashes are used (e.g., google-forms, google-sheets).
- You can also check the exact app name using the Make DevTool's Highlight App feature. See the instructions here.
- Optional: In the Limit field, you can specify how many connections you want to get in the output.
Click Save.
Click the Run once button in the Scenario Builder toolbar.
Click the operation bubble above the module.
In the Output, expand Body > Connections.
In the output, you will see:
- Your new and old connections' respective IDs.
- Your new and old connections' names. To identify the old and new connection names, compare the Name in the output with the name used when creating the connection.
- Under Account name, the type of connection you searched for.
Copy the IDs for the next steps.
Create a scenario to replace connections
You can use our template with a pre-set scenario to replace the connection, or create a scenario yourself.
In the latter case, you'll need to complete the steps described below to find the relevant scenarios, get their blueprints, and update them using the Make app.
In your Make account, click + Create new scenario.
Add the Tools > Set variables (formerly known as Set multiple variables) module, and set two variables obtained from the previous step:
- Item 1: old_connection_id (Variable name) and its ID (Variable value)
- Item 2: new_connection_id (Variable name) and its ID (Variable value)
Click Save.
To find all the scenarios that use the old connection you want to replace, add the Make > Search scenarios module.
Configure the module settings:
- In the Connection field, choose your Make connection.
- Select your Organization and Team.
- Select the Folder if the required scenarios are stored in a particular folder.
- Use Filters to refine the search by default and/or custom properties. For example, if you need to search for scenarios created by you.
- Choose which scenarios to include in the search: active, inactive, or all.
- In the Limit field, specify how many scenarios to return in the output.
Click Save.
Optional: Add a filter after this module to further narrow down the scenarios that need to be edited. This may be relevant if the Search scenarios module doesn’t allow filtering by the parameters you need.
To retrieve the scenario blueprint you'll work with, add the Make > Get a scenario blueprint module.
Configure the module settings:
- In the Connection field, choose your Make connection.
- In the Scenario ID field, map the Scenario ID from the Search scenarios module.
- Click Advanced settings, and select JSON string in the Return a blueprint field.
Click Save.
Optional: Add a filter for the connection ID to ensure that only scenarios containing the old connection are updated.
- Enter toString(map Blueprint from the Get a scenario blueprint module) to the Condition field.
- Choose Text operator: Contains.
- Enter ("__IMTCONN__": map the old connection variable from the Set a variable module)
Optional: You can temporarily add a Tools > Text aggregator module after the Make > Get a scenario blueprint module. This will list all scenarios that are about to be updated, helping you confirm that the connections will be replaced in the correct scenarios. Once you've verified that, you can either disconnect or delete the Text aggregator module.
To update the scenarios that use the old connection with a new connection, add the Make > Update a scenario module.
Configure the module settings:
- In the Connection field, choose your Make connection.
- In the Scenario ID field, map the Scenario ID from the Search scenarios module.
- In the Blueprint field, add a replace function, map the Blueprint, and add the old and new connection IDs in the following formats: "__IMTCONN__": connection ID.
- Leave the Scenario name and Folder ID fields blank.
Click Save.
Click the Run once button in the Scenario Builder toolbar.
All the old connections in the scenarios you selected will be updated to new ones.
How to confirm the connections are replaced correctly
To verify that the right connections have been replaced in your scenarios, follow these steps.
After running the full scenario, add a Tools > Text aggregator module after the Make > Update a scenario module. Select Make > Update a scenario as a source module, and map Name and Scenario ID from that module.
Run the scenario again. If the connection was successfully replaced, this second run should return 0 results (i.e., there’s nothing to replace).
After running the full scenario, you can also set a filter to find scenarios that use the new connection.
- Enter toString(map Blueprint from the Get a scenario blueprint module) to the Condition field.
- Choose Text operator: Contains.
- Enter ("__IMTCONN__": map the new connection variable from the Set a variable module)
If you run the scenario again, it should return all scenarios that have the replaced connection.
Troubleshooting
Here you can find solutions for the most common issues when replacing the connection across multiple modules in Make.