Plans: Growth and Enterprise · In the app: Settings → Security → Single sign-on → Provisioning (SCIM 2.0)
Only owners manage SCIM, from Settings → Security → Single sign-on → Provisioning (SCIM 2.0), and every change asks for recent re-authentication.
Before you start
SCIM only provisions people whose email is in a domain your workspace has verified for single sign-on. Set up and verify an SSO connection first. See Single sign-on.Connection details
Issue a token
1
Issue
In Settings → Security → Single sign-on → Provisioning (SCIM 2.0), choose Issue token.
2
Copy it now
The token starts with
scim_ and is shown once, so copy it now.3
Paste it into your IdP
Use it as the bearer token in your IdP’s provisioning settings.
Set up Okta
1
Enable SCIM
In your Quotable app in Okta, enable SCIM provisioning, then open the Provisioning tab.
2
Connect
Set SCIM connector base URL to
https://app.usequotable.com/api/scim/v2, Unique identifier field for users to userName, and Authentication Mode to HTTP Header with your token. Test the connector configuration.3
Choose what Okta may do
Under To App, enable Create Users, Update User Attributes and Deactivate Users.
4
Push groups
Assign people to the app, then use Push Groups for the groups you want to map to roles.
Set up Microsoft Entra ID
1
Open provisioning
In Enterprise applications, open your Quotable app, then Provisioning, and set the mode to Automatic.
2
Connect
Set Tenant URL to
https://app.usequotable.com/api/scim/v2 and Secret Token to your token. Choose Test Connection.3
Check mappings
Make sure
userName maps to the user’s email address (usually userPrincipalName or mail).4
Assign and start
Assign the users and groups in scope, then start provisioning.
Map groups to roles
Your IdP never sends roles. Instead, an owner maps IdP groups to Quotable roles in Settings → Security → Single sign-on → Group → role map.- Groups appear in the map once your IdP pushes them. You can also Map group by display name ahead of time; the mapping is picked up when the group arrives.
- A group can map to viewer, editor, integration admin or billing admin. Owner is never assigned by provisioning.
- A member’s role is the highest role among their groups, in this order: billing admin, integration admin, editor, viewer.
- A member in no mapped group is a viewer.
- Changing a mapping updates every affected member’s role immediately and tells you how many changed.
- Members you invited by hand who are not in any SCIM group keep the role you gave them.
Roles decide what someone can do. Brand access is still granted by an owner in Settings → Members. See Team and roles.
What each operation does
Sessions the person holds in other workspaces are not affected.
Supported endpoints
Filtering and pagination
Filters take a singleeq clause:
startIndex (1-based) and count. The default page size is 100 and the maximum is 200. On /Groups, excludedAttributes=members is honored.
PATCH
PATCH accepts add, replace and remove operations, in any letter case.
- Users:
active,userName,externalId,name.*anddisplayName. Other standard attributes are accepted and ignored. - Groups:
members(includingmembers[value eq "…"]),displayNameandexternalId.
Example user
Not supported
- Bulk operations, sorting, ETags and
/.search. - Filters other than a single
eqclause. - Password changes.
- Changing a member’s email address. A new address sent by the IdP is ignored; the person changes it themselves from their profile.
- Users outside your verified SSO domains.
Limits and errors
Requests are limited to 600 per 5 minutes per workspace. Request bodies are limited to 256 KB. Errors follow the SCIM error format:
Creating a user who already exists in the workspace but is not yet managed by SCIM links them and returns
201, so an IdP retry never creates duplicates.
Audit trail
Every SCIM change is recorded in the audit log: tokens issued and revoked, users provisioned, updated, deactivated and removed, group changes and group-to-role mappings.Next steps
Single sign-on
Required before SCIM can provision.
Team and roles
What each mapped role can do.
Audit log
Review what your IdP changed.