Creating a Tenant In the Integration Hub
Last updated
Last updated
A tenant can be created from the main Tenants resource on the sidebar, or directly from an integration detail page by clicking 'Create Tenant' in the top right of that page.
Either way, you'll then be directed into the tenant creation flow:
Select the release that should be applied to the tenant. The 'Specific Release' option shows a dropdown where all releases that have been built for an integration show and be selected from. Learn more about building releases here.
The 'Channel' option, you can opt for either the 'Default' or 'Latest' channels.
The 'Default' option will set the tenant so that the release version will always match the set Default release of the integration.
The 'Latest' option guarantees that the tenant utilizes the most recently built release version for your integration, regardless of the default integration release set at the integration level.
Then, add a name for identifying the the tenant and then click 'Create' to move to the screen.
Here, depending on the connector type that has been set up for the integration, credential fields will show for the tenant to be authenticated.
For OAuth2.0 connectors, once the authentication flow is completed, Pandium will generate a link that you can send to your customers so that they can authenticate, and give consent to use their app. This is known as the Magic Link. Learn more here.
Clicking 'Next' will show the configuration settings that have been defined for the integration. Learn more about how to configure customizable configurations here.
Please note, that your integration may include dynamic configurations. If this is the case, you will not be able to select these options until you finish creating the tenant and run an init sync.
On the next page, the Sync Schedule can be configured. Select a schedule type: simple or advanced.
To configure a simple schedule, simply select a sync timeframe from the options listed.
To configure an advanced schedule, you'll have to write a cron schedule expression. For assistance with this, you can use Crontab Guru. Please note that the advanced scheduling capabilities are only accessible via the Integration Hub.
Lastly, decide whether the tenant should be paused by default, or immediately begin syncing according to the sync schedule.
Then, click Save Changes.
Note: There is no limit to how many tenants you can have on a single integration.