Overview

Torii integrates with Excalidraw+ and syncs:

• Users, including their role, status and last activity.
• Licenses.
• You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.

Requirements

To connect this integration, we require the following:

Accounts & Permissions

• An Excalidraw+ workspace on the Plus plan. The Excalidraw+ API is available on the Plus plan only, and Excalidraw+ lists it as a public beta.
• An Excalidraw+ workspace where you are an administrator, so you can create API keys in the workspace settings.

Required keys

• API key - a workspace API key with read access to the workspace and users routes. This is enough for syncing users and licenses.
• Write access (only if you want to use Torii actions) - to invite users, change roles and remove users, the key needs full (write) access to the users and invites routes.

How to Generate the Required Values

Follow these steps to generate the required values:

Step 1: Create a workspace API key

1. Sign in to Excalidraw+ as a workspace administrator.
2. Open the workspace settings and go to the API keys section.
3. Create a new workspace API key (not a personal key), so the integration is not tied to a single member.
4. Set the permissions. For syncing only, choose read access to the workspace and users routes. To use Torii actions, also allow full access to the users and invites routes.
5. Choose an expiration date for the key. Once the key expires, the integration stops working and you will need to create a new key and reconnect.
6. Create the key and copy it.

How to Connect the Integration

1. Go to the Integrations page in Torii.
2. Search for Excalidraw+ and click Connect.
3. Enter a unique Account Name and paste the API key.
4. Click Connect.

Actions

The following actions are available in Torii workflows (currently in beta):

• Invite Excalidraw+ user - invites a user to the Excalidraw+ workspace as a Member or Admin. The user shows up in Torii after the next sync, once they accept the invite.
• Change Excalidraw+ user role - changes the role of a workspace member to Member or Admin.
• Remove Excalidraw+ user - removes a user from the workspace.

These actions require an API key with full access to the users and invites routes.

Q&A

Q: What should I enter in the "Account Name" field?

A: The Account Name field lets you connect multiple Excalidraw+ accounts to Torii. The value can be anything you choose. It is only used to distinguish between your connected accounts. Make sure to use a unique Account Name for each account: connecting a different account with an Account Name that is already in use will overwrite the existing account's data, so choosing distinct names is your responsibility.

For any further questions, please contact Torii Support.