Prepare your Make account

After you have received access to Make Bridge, you can select between two methods to prepare your account:

• Make Bridge API method (preferred)

• Make API method (advanced)

Additionally, you can combine these methods to achieve your desired level of integration with Make Bridge.

Make Bridge API method (preferred)

This method provides you with a streamlined API and pre-built, front-end and back-end components for easier, quick implementation and minimal coding.

To begin, you will first set up an application that will serve as a target environment to connect to Make Bridge. Next, you will generate a secret that is used to create JWT tokens for authentication with the Make Bridge API.

Additionally, you can customize how the wizard that can be integrated into your product will look for your users as they create their automations.

There are three key steps to this process:

• Set up an application

• Generate a secret

• Set up visual customization of the integration wizard

Set up an application

To set up an application:

1

Log in to Make.

2

In the left menu, click Bridge settings.

3

Under the Application Setup tab, enter the following information:

Field

Description

Name of your application (required)

Enter a name for your application.

Label (required)

Enter a label to further representation your environment.

URL (required)

Enter the URL of your application. This is needed so we can generate custom code snippets for you.

Description

Optional: Enter a description of your application.

4

Click Save.

You will see a message indicating that your changes have been saved.

Generate a secret

With your application set up, you can now create a secret. You need to include a secret within a JWT token for all communication with Make Bridge.

You can generate up to two secrets that can be used in rotation. You can regenerate the secrets as needed and name them according to your needs.

1

In Bridge settings, click the Secrets tab.

2

Enter a Name for Secret 1 and click Generate.

3

Copy the Generated Secret and Key ID for Secret 1 and save them in a safe place.

4

Optional: Enter a Name for Secret 2 and click Generate.

5

Optional: Copy the Generated Secret and Key ID for Secret 2 and save them in a safe place.

You can now embed your secret in a JWT token.

Here is an example showing the structure of the JWT token and a simple JavaScript snippet that demonstrates how to generate the token and make the API call.

{
	"alg": "HS256",
 	"typ": "JWT",
  	"kid": "de30032f-13e0-45bc-8c3f-8b00c14f1753"
}

{
	"iat": 1735914611,
	"exp": 1735915611,
	"sub": "your-user-id-or-email",
	"jti": "unique-jwt-id-91011"
}

const jwt = require('jsonwebtoken');
const crypto = require('crypto');

// Configuration values – replace with your own
const SECRET_KEY = '04XXXXXXXXXXXXXX';
const KEY_ID = '3XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX';
const ZONE_URL = 'https://eu2.make.com';

/** 
 * Replace with the authenticated user's email or user ID.
 * You can use anything that is unique to the user and can be used to identify the user on both the Make and your system's side.
 */
const userId = '[email protected]';

/**
 * Generates a short-lived JWT for authenticating with the Make API.
 * 
 * @param {string} userId - User ID or email address to be used as the subject (sub) claim in the JWT.
 * @returns {string} A signed JWT string.
 */
function generateMakeBridgeApiJwt(userId) {
  return jwt.sign(
    {
      sub: userId,
      jti: crypto.randomUUID(),
    },
    SECRET_KEY,
    {
      expiresIn: '2m',
      keyid: KEY_ID,
    }
  );
}

/**
 * Calls the Make Bridge Portal API /portal/api/bridge/integrations endpoint using a signed JWT.
 */
async function listIntegrations() {
  const token = generateMakeBridgeApiJwt(userId);
  const url = `${ZONE_URL}/portal/api/bridge/integrations`;

  const response = await fetch(url, {
    method: 'GET',
    headers: {
      Authorization: `Bearer ${token}`,
    },
  });

  const data = await response.json();
  return data;
}

// Example usage
listIntegrations().then((data) => {
  // Use the data as needed
  console.log('Integrations:', data);
}).catch((error) => {
  console.error('Error fetching integrations:', error);
});

Set up visual customization

Your users will be shown an integration wizard, based on a template you will create. This wizard can be integrated within your product and allows your users to create their automations.

To customize the wizard:

1

In Bridge settings, click the Visual Customization tab.

2

Select the elements you would like to customize and add the relevant information.

Items for customization include logo, favicon, service, details of the Flow Initialization page, Flow Finalization page, Module Step page, Connection Step page, Key Step page, Hook Step page, background colors, and CSS override.

3

Click Save.

You will see a message indicating that the settings are successfully saved.

Make API method (advanced)

This method allows you to use the Make API to integrate its functionality into your product. It provides maximum flexibility and customization, but requires more development effort.

There are two key steps to this process:

• Create an API key

• Prepare user-level or team-level structuring

Create an API key

An API key is required to integrate Make Bridge into your product and initialize the flow.

To create an API key:

1

Log in to Make.

2

At the bottom of the left menu, click Profile icon > Profile.

3

Under the API/MCP Access tab, click Add token.

4

In the Type field, select API token.

5

Select your required Scopes. Initially, for testing purposes, we recommend that you select all scopes.

Actions

Scopes

Working with connections:

connections:read

connections:write

Working with webhooks:

hooks:read

hooks:write

Rendering the forms in the flow:

imt-forms:read

Working with keys:

keys:read

keys:write

Reading details of the organization, checking permissions and licenses, etc.:

organizations:read

Working with scenarios:

scenarios:read

scenarios:write

Managing teams:

teams:read

teams:write

Working with templates:

templates:read

templates:write

Working with the instancing flows:

instances:read

instances:write

6

Enter a Label to identify the use of this token.

7

Click Add.

8

The new key will appear in the API Access dashboard. Copy the API key to your clipboard and store it in a safe place, as it will not be shown again.

Prepare user-level or team-level structuring

Depending on your users’ requirements and how you wish to divide data, you can set up user-level or team-level structuring.

User-level structuring is the best option if you want the scenarios generated by each user to not overlap or be shared with other users. Team-level structuring is preferred if you want multiple users from the same user base to leverage the same assets (scenarios, connections, webhooks).