creating a tenant.md

Creating a Tenant In the Integration Hub

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:

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 can be selected from. Learn more about building releases here.

Then, add a name for identifying the tenant and then click 'Create' to move to the screen.

{% hint style="danger" %} Please Note: There is a 63 character limit for tenant names. {% endhint %}

Here, depending on the connector type that has been set up for the integration, credential fields will show for the tenant to be authenticated.

Clicking 'Next' will show the configuration settings that have been defined for the integration. Learn more about how to configure customizable configurations here.

On the next page, the Sync Schedule can be configured. Select a schedule type: simple or advanced.

Sync Schedules

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.