Skip to main content

SCIM Provisioning

SCIM (System for Cross-domain Identity Management) automates user and group lifecycle management between your identity provider and Willow. When configured, your IdP creates, updates, and deprovisions users and groups in Willow automatically, with no manual admin work required.

What SCIM does in Willow​

When a user is assigned to the Willow app in your IdP:

  • Willow creates the user account automatically
  • User attributes (name, email) stay in sync when changed in the IdP
  • When the user is unassigned or deprovisioned in the IdP, Willow deactivates their account

A deactivated user is hidden from the Users page by default (turn on Show deactivated to see them) and is left out of group member counts, member lists, and the members your IdP reads from Willow's SCIM group endpoints. Willow keeps their group memberships, so a reactivated user gets their groups back.

Group push syncs IdP groups to Willow, enabling group-based access control.

Prerequisites​

  • SSO must already be configured in Willow (SCIM uses a separate API token, not the SSO credentials)
  • You need admin access in both Willow and your IdP

SCIM base URL and authentication​

All SCIM endpoints are under /scim/v2.

  • SaaS: https://app.withwillow.ai/scim/v2
  • On-Premise: {your-app-url}/scim/v2

Authentication uses an API token in the Authorization header:

Authorization: Bearer <YOUR_API_TOKEN>

Find the URL and token in Authentication Settings​

Settings → Authentication Settings has a SCIM Provisioning card with the SCIM base URL (with a copy button), the number of active SCIM tokens and when one was last used, and a Generate SCIM token button that opens the token dialog with the admin:scim scope already selected. The card also links to Manage API tokens and the SCIM logs. You need permission to read API tokens to see it, and to create them to generate one.

Generate a SCIM API token​

  1. In Willow, go to Admin → API Tokens
  2. Select Generate Token
  3. Enter a descriptive Token Name (e.g. "Okta SCIM Integration")
  4. Under Permissions, select the SCIM scope ("SCIM user and group provisioning")
  5. Select Generate
  6. Copy the token immediately; it is shown only once

You can also manage SCIM from Admin → Settings → Authentication Settings → SCIM Provisioning. It shows the SCIM base URL, how many active SCIM tokens you have and when they were last used, and generates a token with the SCIM scope already selected.

Select a provider​

Willow supports SCIM provisioning through Okta, JumpCloud, and Microsoft Entra ID. Select your provider to continue:

For the complete SCIM API reference (endpoints, request and response examples, error codes), see the SCIM API reference.

Monitor SCIM logs​

Willow logs all SCIM provisioning operations from your IdP. To access them, go to Settings > Authentication and select SCIM logs on the SCIM Provisioning card. On SaaS, you can open the page directly at app.withwillow.ai/monitor/scim-logs. The Monitor > Logs page also has a SCIM logs view under Views > All views... > Audit.

SCIM Logs page showing an empty state before any provisioning operations have occurred

What is logged​

  • User operations: create, update, deactivate
  • Group operations: create, update, delete membership
  • Configuration queries: ServiceProviderConfig, Schemas, ResourceTypes
  • Request and response details: full payloads for debugging

Filter logs​

Filter by Date Range, HTTP Method (GET, POST, PATCH, PUT, DELETE), Resource Type (User, Group, Config, Schema), or Status Code (2xx, 4xx, 5xx).

Export logs​

Select Export CSV to download all filtered logs for offline analysis or compliance reporting.

Troubleshoot​

Connection test fails​

  • Verify the API token is correct and copied without extra whitespace
  • Ensure the SCIM base URL is reachable from your IdP's network
  • Confirm URLs were entered without a trailing slash (Okta OIN)

Users not syncing​

  • Confirm users are assigned to the Willow app (directly or via an assigned group)
  • Check that Create Users is enabled under Provisioning → To App
  • Review your IdP's provisioning logs for error messages

Can't change a group's members or name in Willow​

Groups provisioned through SCIM carry a SCIM badge on the Groups page. Edit their names and membership in your identity provider, then sync the changes to Willow. In Willow, their membership is read-only, they are excluded from user group pickers, and CSV imports leave their membership unchanged.

Group sync issues​

  • Groups must be both assigned and pushed (Okta) or covered by the Identity Management config (JumpCloud)
  • Verify groups have members before syncing
  • Check provisioning logs for group operation errors
  • Willow lists up to 10,000 members of a group in its SCIM group responses. Members beyond that are not returned to your IdP
  • Willow's SCIM Groups list accepts one displayName, externalId, or id filter with eq or sw. Any other filter gets a 400 invalidFilter error. Open the request in the SCIM logs to see the exact filter your IdP sent