Quip
Quip treats documents and messages as threads. The Glean Quip connector indexes threads Glean can reach through the Admin API so your organization can search documents, spreadsheets, and (optionally) folders in Glean.
Supported features and limitations
Indexing depends on what your Quip tenant exposes through the Quip Admin API and your Salesforce contract (for example Events).
Supported objects
- Documents (threads of type
document) - Spreadsheets (threads of type
spreadsheet) - Folders (only when folder support is enabled)
Supported behavior
- List threads (documents and spreadsheets) via the Quip Admin API
- Read thread body and metadata (title, author, created and updated times, permissions)
- Read folder metadata and hierarchy when folder indexing is on
- Read document- and folder-level sharing for permission-aware behavior in Glean
- Activity and events only if you license the Quip Events API add-on from Salesforce (not part of the default setup)
Limitations
- Chat rooms, thread comments, and tasks are not ingested
- Folders are off by default; turning them on can require extra configuration
- Only data available through the Quip Admin API is indexed; personal tokens from
quip.com/dev/tokenare not supported - Default Admin API rate limit is 100 requests per minute per user (Salesforce can raise it on request)
- Near-real-time activity requires the Salesforce add-on for the Activities API
Requirements
You need Admin API access, OAuth credentials, the right Quip admin roles, and Glean admin access.
Technical requirements
- Quip Admin API enabled for your org (off by default—request it from Salesforce)
- Access to a live Quip tenant and company admin privileges
- Ability to create and rotate OAuth 2.0 client credentials for the integration
- (Optional) A higher Admin API rate limit for large orgs
Credential requirements
- Client ID and Client secret from your Quip Admin API OAuth app
- Access token and refresh token with
ADMIN_READandUSER_READ - The integration user must appear on the Admin API users list in Quip with the admin API management permission (that permission is hidden until Admin API is enabled)
- Your Quip company ID (from the Quip admin console)
- Your Quip instance hostname (for example
yourcompany.quip.com) - A dedicated Quip user (service-style account) used only for Glean—strongly recommended
Before you connect
- Ask Salesforce/Quip support to enable the Quip Admin API
- (Optional) Ask support to raise the per-user limit toward 500 requests per minute (default is 100)
- In Quip, create an OAuth application named Glean with
ADMIN_READandUSER_READ - In the Quip admin console, copy the company ID and confirm the instance hostname
- Add the integration user to Admin API users with the required permissions
- (Optional) Purchase the Quip Events API add-on if you need activity or event ingestion
Configuration and setup
Work is split between Quip (API access, OAuth app, IDs) and the Glean Admin console (fields, authorize).
Prerequisites
- Quip company admin access
- Glean admin access to configure connectors
- Admin API enabled and OAuth values ready (see Before you connect)
Enable the Quip Admin API
- Confirm the Admin API is allowed for your org. If it is not on yet, follow Salesforce/Quip support guidance—see Quip Admin API requirements. When you request enablement, ask to raise the per-user rate limit to 500 requests per minute if you expect a large corpus (default is 100).
- As a sanity check, call the
/users/listendpoint with admin credentials.
Add Quip identifiers in Glean
- As an admin in Quip, open Admin console → Settings → Site settings → Site profile and copy the company ID into the matching field in Glean.
- Enter the Quip instance name (subdomain only). For example, if you use
https://acme.quip.com, enteracme.
Generate a Quip API key and authorize Glean
- In Quip, go to Admin console → Settings → Integrations → New API key. Enable only
ADMIN_READandUSER_READ. - In Glean, paste the Client ID and Client secret from that key into the connector fields.
- In Glean, click Authorize and complete the flow from the link you are given.
For authentication details, see Quip automation API authentication.