Overview
Torii integrates with Quip and syncs:
- Users
- 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
- A Quip administrator account. Only a Quip admin can create an API key.
- The admin must be on the Admin API Users list in the Quip Admin Console, under Settings > Site Settings. Quip requires this for any Admin API access.
Plan
- Quip API access comes with Quip Advanced, Quip for Customer 360, or Salesforce Lightning Experience (Enterprise, Professional, Performance, Unlimited, or Developer edition).
- The Admin API must be turned on for your company. If it is off, ask Quip support to turn it on.
Scopes
- ADMIN_READ - for retrieving the list of users in your Quip company and their account details.
- USER_READ - for identifying your Quip company when Torii connects.
Required keys
- Client ID of your Quip API key
- Client Secret of your Quip API key
How to Generate the Required Values
Follow these steps to generate the required values:
Step 1: Confirm Admin API access
- Sign in to Quip and open the Admin Console.
- Go to Settings > Site Settings.
- Make sure the admin who will connect Torii is on the Admin API Users list. Add the admin if needed.
Step 2: Create an API key
- In the Quip Admin Console, go to Settings > Integrations.
- Create a new API key. Give it a name that identifies Torii, for example "Torii".
- Select the scopes ADMIN_READ and USER_READ.
- Set the redirect URI to https://api.toriihq.com/api/auth/quip/callback.
- Save the API key.
Step 3: Copy the Client ID and Client Secret
- Copy the Client ID and Client Secret of the API key you created.
Important
Store the Client Secret securely. Quip lets you create a limited number of API keys per company, and you can revoke a key at any time from Settings > Integrations.
How to Connect the Integration
- Go to the Integrations page in Torii.
- Search for Quip and click Connect.
- Enter the Client ID and Client Secret.
- Click Connect.
- Approve the access request on the Quip consent screen.
Q&A
Q: How long does the first sync take for a large Quip company?
A: Quip limits how many user detail requests can be made per hour, so large companies sync slowly, at roughly 1,500 users per hour. Companies with more than 25,000 users are not fully synced.
For any further questions, please contact Torii Support.