This guide will show you how to implement the Marketplace in your solution now that you have already developed your own connector and built your own integration templates. Implementing the Integration Center just takes a few easy steps. Ready? Let’s go.

Untitled

In order to implement the Integration Center in your own application, we provide a Web Component that can be embedded at any location you desire. By generating and passing a User Token to the web component, you ensure that each of your users can view and manage their own integrations, whenever they want.

In order to activate the Integration Center for your users, you first need an API Token for your Tenant Admin account. Please contact us at [email protected] to generate a Token for you.

Log-in the User

{
  "username": "abc123"
}

The first time you call this endpoint, the user will be created in our system with the ID you provide. All subsequent calls for this user must use the same username. For this reason, we suggest using a hash of an identifier from your own system, so that it can be generated for each call.

It is also possible to automatically pass a user credential for your system, which can then be used when setting up flows. In order to do this, add a “credential” parameter to your /impersonate request, and pass the required values for your credential type.

Once you have a token for your admin, you will use this to generate User Tokens each time a user loads the integration center. This step should always be handled server-side, so as not to leak your Admin Token to users. This is done by making a POST request to https://api.platform.openintegrationhub.com/impersonate with a JSON body containing the User ID.

<aside> 🎯 To activate this feature, you need to set a Default Connector for your Tenant in the Admin UI. From Settings>Account-Profile>Tenant Settings, update the “Default Connector” to display your own Connector. This Connector must also be activated for your account (In the Connectors menu, select your Connector. If the button “Activate Connector” is showing on the details page, click it and follow the instructions).

</aside>

These would include: