--- title: miniOrange API Integration on Truto slug: miniorange category: IM canonical: "https://truto.one/integrations/detail/miniorange/" --- # miniOrange API Integration on Truto **Category:** IM **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Groups** — Groups are a collection of users in the source application. In some applications, they might also be called Teams. - **Users** — The User object represents a User. ## How it works 1. **Link your customer's miniOrange 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 miniOrange.** The Proxy API is a 1-to-1 mapping of the miniOrange 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 - **Sync enterprise directories from miniOrange into your SaaS app** — If your customers manage identities in miniOrange, you can pull their Users and Groups into your product to automate account creation and role assignment — no CSV uploads or manual admin work required. - **Automate seat-based license management** — SaaS companies that charge per seat can sync user status from miniOrange in real time, automatically deprovisioning inactive users to free up licenses and close security gaps when employees leave. - **Enforce group-driven access control without custom SCIM work** — Instead of building and maintaining a bespoke SCIM integration, your product can ingest miniOrange Groups through Truto's Unified User Directory API to map corporate groups to in-app roles and permissions. - **Offer miniOrange as a native integration for government and education customers** — miniOrange is widely adopted in regulated and legacy-heavy sectors like government, education, and healthcare. Offering it as a supported directory integration helps you close deals with these high-value segments. - **Keep user profiles in sync across HR changes** — When an employee's department, title, or status changes in miniOrange, your app can automatically reflect those updates — keeping profile data accurate without requiring end users or admins to intervene. ## What you can build - **One-click directory import from miniOrange** — Let your customers connect their miniOrange account and bulk-import all users and groups into your app during initial setup. - **Automated user provisioning and deprovisioning** — Create accounts when new users appear in the miniOrange directory and suspend or remove them when they are deactivated, all without manual admin action. - **Group-to-role mapping engine** — Allow customers to map their miniOrange groups (e.g., 'IT_Managers', 'Sales_Team') to roles in your product so that permissions are always governed by the central directory. - **Real-time profile sync dashboard** — Surface a UI that shows your customers the sync status of their miniOrange directory, including last sync time, user count, and any conflicts or errors. - **Scheduled directory reconciliation** — Run periodic syncs against the miniOrange directory to catch any drift between your app's user records and the source of truth, flagging mismatches for review. - **Bulk student or employee enrollment via group membership** — Enable LMS or workforce platforms to enroll thousands of users into the correct courses, teams, or workspaces based on their miniOrange group assignments. ## FAQs ### What Unified APIs does Truto support for miniOrange? Truto supports the Unified User Directory API for miniOrange, covering Users and Groups as core resources. This lets you read user profiles, group memberships, and status information through a single standardized interface. ### Are there pre-built tools available for miniOrange on Truto? miniOrange tools are built on request. If you need this integration, contact Truto and the team will build and deliver the connector based on your specific requirements. ### What authentication methods does miniOrange support? miniOrange supports standard identity protocols including SAML 2.0, OIDC, and OAuth 2.0 for SSO, as well as SCIM 2.0 and REST APIs for directory operations. Truto handles the auth flow so you don't need to manage tokens or session lifecycle yourself. ### Can I access custom user attributes from miniOrange? miniOrange supports custom enterprise attributes on user profiles. When Truto builds your connector, it can map these custom fields into the Unified User Directory API so they're available alongside standard fields like email, name, department, and job title. ### Does this integration work with on-premise miniOrange deployments? miniOrange offers on-premise, private cloud, and multi-tenant cloud deployments. Truto can work with any deployment model as long as the miniOrange API endpoints are accessible, which may require network configuration for on-premise instances. ### What user and group data can I expect from the integration? For Users: unique ID, active/inactive status, email, first and last name, job title, department, and custom attributes. For Groups: group ID, group name, and member lists. This covers the core data needed for provisioning, deprovisioning, and role mapping workflows.