Creating Connectors

Last modified: June 13, 2025

Introduction

Mendix connectors allow you to connect your Mendix application to other systems. You can find them on the Mendix Marketplace, or add them to the Marketplace for others to use.

This how-to teaches you the following:

  • What connectors are and how they work
  • Basic steps for building and publishing connectors

Prerequisites

Before starting this how-to, make sure you have completed the following prerequisites:

Connectors Defined

Connectors can be used in your app to simplify connecting to existing third-party systems or other Mendix applications.

Connecting to Other Systems

Connectors are implemented as Mendix modules focused on connecting to other systems. They can use any of the platform-supported protocols like SOAP, REST, OData, or Catalog.

Connectors can also be used to package a Java library provided by the other system to make the connection. These Java library functions can be exposed via Java actions as custom microflow activities. This makes it simpler for Mendix developers without in-depth knowledge about third-party integrations to use these connectors in their business logic.

Connecting Mendix Apps to Mendix Apps

This table shows the solutions you can use when you want to connect Mendix apps to other Mendix apps:

Category Solution
Platform-supported protocols Connect to two or more Mendix applications using platform-supported facilities:
Unsupported protocols Build a module to connect either with alternative protocols, or by encapsulating one of the platform supported protocols. You can do this with Java actions or JavaScript actions.

Connecting Mendix Apps to Third-Party Systems

This table shows the solutions you can use when you want to connect Mendix apps to third-party systems:

Category Solution
Platform-supported protocols Connect a Mendix application to one or more third party applications using platform-supported facilities:
  • SOAP web services
  • REST web services
  • OData
eQube-supported protocols Use eQube-supported facilities:
  • Web services
  • REST
  • OData
Unsupported protocols Build a module to connect either via alternative protocols, or by encapsulating one of the platform supported protocols.

Getting Mendix Connectors

Many existing Mendix Connectors can be downloaded from the Mendix Marketplace directly into your app. Depending on your use case, your company’s private Mendix Marketplace could also have a variety of Mendix connector modules available. For more information on the distinction between public and private Marketplace content, see the Adding New Marketplace Content section of Uploading to the Marketplace.

Connectors expose data via custom microflow activities. As such, you can find them in the Studio Pro Toolbox to implement when building your application logic. Then, you can drag them to where you want to use the connector functionality.

Deploying Connectors

Once you deploy an application, the connector automatically deploys with it. You can also set a few runtime or node specific configurations (via the application interface or constants).

As an example, check out the Amazon SNS connector. This uses AWS-provided libraries to interact with the Amazon Simple Notification Service. The functions are exposed via a set of Mendix actions that are available in the toolbox to use in your logic.

Building a Mendix Connector in Studio Pro

When creating a new Mendix connector, it is advised to have an app in which you both develop and test your connector. This means that you will have a module that contains all your connector logic, along with one or more additional modules that assist in the testing and development. The logic in the additional modules is not required for the main module to operate, and therefore needs to be separated.

Setting Up Your App

To start setting up your app, open Studio Pro and do the following:

  1. Create a new app for your connector.

  2. Create a module to contain your connector. To do this, right-click anywhere in the App Explorer outside of existing modules, and choose Add Module.

  3. Give your module a name fitting for the type of connector you are building.

  4. Create the basic folder structure at root level.

For more information, see the App Setup section of Best Practices for Building Connectors.

Implementing the Connector

How you implement the connector is entirely up to you and your use case, but it is good to keep the following in mind:

  • Document the parts that are to be used by the implementing application.
  • Provide a granular security model that allows the implementing application to use your connector in a secure way.
  • Hide complex parts, preferably in the Java code, or at least in the private folder.
  • Apply Intellectual Property (IP) protection to your Mendix module. For more information, refer to Applying Intellectual Property Protection.
  • Minimize dependencies to easily available libraries/modules that are well maintained. Where possible, do not use any dependencies.
  • Contain all your core code in your connector module. Anything assisting you during development or testing should be in separate modules using the connector module, but never the other way around.
  • Test your connector.

Exporting the Connector

Mendix connectors are like any other Mendix module, which means you can export them from your app. When a connector module is exported, the following are also exported:

  • Entities
  • Microflows
  • Pages
  • Java actions
  • Theming (from the themesource folder) [only for Mendix Studio Pro 9 and above]
  • Specified user library files (from the userlibs folder)
  • Specified resource files (from the resources folder)
  • Specified related Java files (from the modules subfolder in the javasource folder)

Exporting as an .mpk File

To export your connector as an .mpk file, do the following:

  1. Ensure your version is aligned with the version number that appears on the Marketplace. Versioning in Marketplace starts at 1.0.0 (for more information, see the Adding New Marketplace Content section in Uploading to the Marketplace). You cannot use Marketplace to distribute your connector if it is below version 1.0.0.
  2. Generate the export module package using your Gradle script.
  3. Build and export a release candidate with versioning and put it in the Marketplace DIST folder. You can create this folder to contain the releases of your module for reference.

Distributing the Connector

To share your connector with other developers and the wider community, you can publish it in the Mendix Marketplace. You can choose to publish it for everyone or just for your company. If you choose to only publish for your company, it will only be available to other developers belonging to the same company as you. For more information on how to publish to the Marketplace, and the difference between public and private publishing, see the Adding New Marketplace Content section of Uploading to the Marketplace.

Once you publish the connector and someone imports it in their Mendix app, all of these elements will be placed in the same location from which they are exported.

You can distribute the module to those who want to use it, by either sharing the file or uploading it to the Marketplace. Follow these steps to do so:

  1. Keep the release notes ready.

  2. Deploy to GitHub by doing the following:

    1. Commit the code to GitHub (if you have not already made this a Git project).
    2. Create a new release.

  3. Create the release in Marketplace using the release from GitHub.

Architectural Impact

Connectors are exported as modules, and then published to the Marketplace. For this reason, they are as decoupled as possible from your development application. This is needed because a copy of the module will be imported in other applications when users download the module from the Marketplace. The implementing application might need to configure some constants, add specific microflows, use pages or snippets, configure specifics on runtime, but it will always be a standalone situation.

Read More