Skip to main content

Connect an application

To allow your scenarios to get information from and send it to third-party applications, you need to create a connection. For example, a connection lets Make check your Gmail and enter the sender and subject into Google Sheets.

Because third parties have different technologies and standards, there are different ways to create connections in Make. For some apps, creating a connection requires logging in to the third-party app and clicking that you agree to let Make access your profile and data. Other third parties require an API key or OAuth credentials.

Make offers two types of connections:

  1. Standard - the most common kind of connection and the type explained in this article.

  2. Dynamic - a feature for Enterprise customers that lets you easily switch between multiple connections. This way you can have a separate connection for each team or department in your company and change them as needed.

Create a connection

You create connections in the scenario editor when you add a module. All users in your team can use any connections you create in that team. Use your personal third-party account and credentials carefully, especially when your team has other users.

Important

All team members can manage connections as well. If you want to connect Make with your personal account or data, consider creating a separate team where you are the only member.

The following is the general way to create a connection. For more details, see the article on the specific app you want to connect.

  1. Go to your scenario and add a module. For example, click + and search for Dropbox. Then select the module you want, such as Create a Folder.

    slack_createaconenction_button.png

  2. Click Create a connection.

    dropbox_standardconn.png

  3. In the Connection name field, you can name your connection. For example, if you have two different Dropbox accounts, you might name one Dropbox-Company, and the second Dropbox-Personal.

    Tip

    If your app has fields for:

    • Credentials such as username and password

    • API Key

    • Client ID and client secret

    • Anything not on this list

    Refer to the article on the specific app you want to connect for more information.

  4. Click Save. A new window prompts you to grant Make access to your data.

    Tip

    Steps 4 and 5 can vary. Carefully follow on-screen instructions when granting consent.

  5. Grant Make access to your Dropbox account and data.

You created a connection between your Dropbox account and Make and you can continue setting up the module. You can find the connection in the Connections section:

connection_list_team.png

Manage connections

The connections tab lets you do any of the following to your connections:

  • Edit

  • Verify

  • Reauthorize

  • Delete

You can find the connections by clicking connectionsMenu.png in the left sidebar.

Edit connections

You can edit your connections after you create them. Click Edit to open a pop-up where you can fill in the new data for the connection.

Editing a connection replaces the original data with the new data, so you have to provide all the credentials necessary to create the connection. Make doesn't keep the original connection.

After you edit a connection, all modules that use the connection will start using the new credentials automatically.

Caution

Keep in mind that the API key or OAuth connection must have proper scopes to allow Make modules to do actions on your behalf. Before you edit a connection, make sure that the new connection has access to all the features you need, especially if you use the Make an API call module of the app.

Make cannot ensure that the edited connection has the scopes required for all modules that use the connection.

If a module uses a connection with insufficient scopes, the scenario ends with the AccountValidationError.

Edit API key connections

Editing an API key connection is similar to creating the connection, except that Make prefills the connection data based on the original connection.

To edit an API key connection:

  1. Go to the Connections page with the list of connections associated with your team.

  2. Click the Edit button in the row with the connection you want to update.

    jira-connection-example.png

  3. A pop-up appears. Fill in the new data in the form. Make creates a new connection from the data and replaces your old connection. This means, that even if your API key didn't change, you have to provide the key again to authenticate the updated data.

    jira-connection-update-form.png

    Note

    Different apps may have a slightly different connection editing form. The example uses the JIRA Cloud Platform connection.

  4. Confirm changes with the Save button.

    If you click the Close button, Make closes the form and keeps your original connection.

Make applies the changes immediately. After confirming, all modules that were using the old connection use the new one instead.

Edit OAuth connections

Editing an OAuth connection is similar to creating the connection, except that Make prefills the connection data based on the original connection.

To edit an OAuth connection:

  1. Go to the Connections page with the list of connections associated with your team.

  2. Click the Edit button in the row with the connection you want to update.

    edit-cf-connection.png

  3. A pop-up appears. Fill in the new data in the form. Make creates a new connection from the data and replaces your old connection. This means, that even if your API key didn't change, you have to provide the key again to authenticate the updated data.

    edit-confluence-oauth-connection.png

    Note

    Different apps may have a slightly different connection editing form. The example uses the Confluence connection.

  4. Confirm changes with the Save button.

    If you click the Close button, Make closes the form and keeps your original connection.

  5. Fill in the OAuth access form. Check the required fields to create the connection and review the connection scopes. If everything is correct confirm the connection update with the Accept button.

    editing-confluence-connection-oauth-form.png

Make applies the changes immediately. After confirming, all modules that were using the old connection use the new one instead.

Verify connections

You can see whether your connection works by clicking verify. The button briefly changes to Verifying ... as Make checks. A green check mark in a circle appears when successful.

Reauthorize connections

Some third parties, such as Google only grant access for a limited time. In this case, you may need to occasionally reauthorize your connection. Just click Reauthorize and follow any on-screen prompts that appear.

Delete connections

If you need to delete a connection, click Delete. The button turns red and asks again to confirm that you want to erase that connection. Click again to delete your connection.

Caution

Deleting a connection may cause your scenarios to stop working. Be sure that the connection is not used in any scheduled or active scenarios.

In this section: