Overview
Torii integrates with Mosaic and syncs:
- Team members (users), including their status (active or archived)
- Licenses (one license named Mosaic)
- You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.
Requirements
Accounts & Permissions
- A Mosaic team account.
- Access to your Mosaic Customer Success Manager (CSM), who provides the API credentials.
- API access approved for your team by your Mosaic CSM. Mosaic does not publish which plans include API access.
Required keys
To connect this integration, we require the following:
- API Key
- Team ID
- Origin Domain - the domain you tell your Mosaic CSM that Torii will use (for example, https://example.com).
- API Server URL (Optional) - only for teams on a single-tenant Mosaic deployment.
- Tenant (Optional) - defaults to "prod".
- Realm ID (Optional) - defaults to "prod".
How to Generate the Required Values
Step 1: Request an API key and Team ID from Mosaic
- Contact your Mosaic Customer Success Manager.
- Ask for an API key and your Team ID for Torii.
- Tell them the domain you will enter in Torii as the Origin Domain (for example, https://example.com). Mosaic ties the API key to this domain, so the value you enter in Torii must match it.
Important
Mosaic does not document which permissions an API key needs. Ask your CSM to provide a key with access to your team's members.
Step 2: Identify single-tenant details (only if relevant)
- Most teams do not need this step. Leave API Server URL, Tenant and Realm ID empty and Torii uses the default ("prod").
- If your team uses a dedicated (single-tenant) Mosaic deployment, ask your CSM for your API Server URL, Tenant and Realm ID.
How to Connect the Integration
- Go to the Integrations page in Torii.
- Search for Mosaic and click Connect.
- Enter the API Key, Team ID and Origin Domain. Fill in the optional fields only if your team is on a single-tenant deployment.
- Click Connect.
Actions
The Mosaic actions are currently in beta. You can use them in Torii workflows:
- Create User - adds a member to your Mosaic team (email, and optionally first name, last name and employment type: Member, Contractor (Internal), Contractor (External) or Guest).
- Update User - updates a member's first and last name.
- Delete User - archives a member in Mosaic. Mosaic does not delete members.
Q&A
Q: Does a Mosaic action take effect immediately?
A: Not always. Mosaic applies changes asynchronously. Torii reports the action as successful once Mosaic accepts the request, which can be before the change is visible in Mosaic.
Q: Can I update or delete a user I just created from Torii?
A: Only after the next Mosaic sync. Update User and Delete User rely on the member ID that Torii receives during sync, and a newly created member appears in Torii after that sync.
For any further questions, please contact Torii Support.