--- title: Jostle SCIM API Integration on Truto slug: jostlescim category: Default canonical: "https://truto.one/integrations/detail/jostlescim/" --- # Jostle SCIM API Integration on Truto **Category:** Default **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Me** — - **Users** — The User object represents a User. ## How it works 1. **Link your customer's Jostle SCIM account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Jostle SCIM.** The Proxy API is a 1-to-1 mapping of the Jostle SCIM API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Automate employee provisioning into Jostle's intranet** — If you build an HRIS or onboarding platform, your customers expect new hires to have day-one access to their company intranet. Integrating with Jostle SCIM lets you automatically create user accounts with correct department, location, and manager data — no IT tickets required. - **Keep your org chart in sync with Jostle's directory** — Employee engagement, recognition, and analytics platforms depend on accurate organizational data. By reading from Jostle SCIM via Truto's Unified User Directory API, you can continuously mirror department hierarchies and reporting structures without manual CSV imports. - **Enforce instant access revocation on offboarding** — IAM and SaaS management platforms need to guarantee zero lingering access when an employee leaves. Offering a Jostle SCIM integration lets your product deactivate and remove intranet accounts the moment a termination event fires, closing a common compliance gap. - **Power targeted communications with enriched user profiles** — If your product handles internal communications or content targeting, syncing user attributes like department, location, and title from Jostle SCIM enables precise audience segmentation without requiring end users to maintain separate distribution lists. - **Centralize directory management across dozens of SaaS tools** — IT operations platforms that manage identity across a customer's entire SaaS stack can add Jostle as a supported integration, letting admins provision, update, and deprovision Jostle accounts from a single control plane alongside their other tools. ## What you can build - **Day-one intranet account provisioning** — Automatically create a fully populated Jostle user profile — including name, title, department, and manager — when a new hire is confirmed in your platform. - **Real-time directory ingestion and sync** — Pull the complete Jostle user directory into your application on a schedule to keep org charts, department rosters, and reporting hierarchies up to date. - **Lifecycle-aware access revocation workflow** — Deactivate and then delete a Jostle user account in the correct two-step sequence when an employee is offboarded, ensuring compliance with GDPR and internal security policies. - **Bulk directory reconciliation for large orgs** — Leverage Jostle's bulk endpoint support to push large-scale organizational changes — like a company-wide restructuring — in a single synchronization run rather than hundreds of individual API calls. - **Profile attribute change detection** — Detect promotions, department transfers, and name changes by comparing synced Jostle user records over time, and trigger downstream workflows in your product automatically. - **Unified user lookup across identity providers** — Let your customers search and browse their Jostle directory alongside other connected user directories through Truto's Unified User Directory API, with a single consistent data model. ## FAQs ### How do end users authenticate their Jostle SCIM connection? The end user must create an 'Automation User' inside their Jostle Admin Settings, log into that account once to activate it, and then generate an API token from that account. This token is used to authenticate all SCIM requests. ### What data can I access through the Jostle SCIM integration? You can access standard SCIM user attributes including id, userName (email), first and last name, title, department, and manager. Jostle also exposes custom schema extensions such as alternate email labels through its urn:ietf:params:scim:schemas:extension:jostle:2.0:User namespace. ### Are there any quirks with deprovisioning users in Jostle SCIM? Yes. You must first send a PATCH or PUT request to set the user's active status to false before issuing a DELETE request. Attempting to delete an active user directly will not follow Jostle's expected lifecycle and may fail or produce unexpected results. ### Does the integration support bulk operations? Jostle SCIM exposes a POST /scim2/Bulk endpoint that supports bulk synchronization, which is useful for large-scale provisioning or organizational restructuring scenarios. ### Which Truto Unified APIs map to Jostle SCIM? Jostle SCIM is mapped to Truto's Unified User Directory API, which includes the Me and Users resources. Specific tools are built on request — contact Truto to enable coverage for your use case. ### Can I perform incremental updates to user profiles? Yes. Jostle SCIM supports PATCH requests on individual user records, allowing you to update specific attributes like title or department without overwriting the entire user profile.