--- title: LearnWorlds API Integration on Truto slug: learnworlds category: Default canonical: "https://truto.one/integrations/detail/learnworlds/" --- # LearnWorlds API Integration on Truto **Category:** Default **Status:** Beta ## 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. - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. ## MCP-ready AI tools Truto exposes 5 tools for LearnWorlds that AI agents can call directly. - **list_all_learnworlds_users** — List all users in LearnWorlds. Returns an array of user objects with fields such as id, email, username, created, last_login, role, tags, and status. The response also includes pagination metadata under the meta object. - **get_single_learnworlds_user_by_id** — Get details about a specific user in LearnWorlds using id. Returns id, email, username, role, account status fields (is_admin, is_instructor, is_suspended), creation and login timestamps, billing_info, fields, utms, tags, nps_score, and nps_comment. - **list_all_learnworlds_roles** — List all user roles in LearnWorlds. Returns id, title, description, access_level, and custom_role for each role in alphabetical order by title. - **list_all_learnworlds_groups** — List all user groups in LearnWorlds. Returns each group's id, title, description, products, enroll_users_on_courses, group_managers, tags, created, and modified fields in the response. - **get_single_learnworlds_group_by_id** — Get a user group in LearnWorlds using the required id. Returns fields such as id, title, description, products (courses), enroll_users_on_courses, group_managers (id, username, email, role_id), tags, created, and modified timestamps. ## How it works 1. **Link your customer's LearnWorlds 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 LearnWorlds.** The Proxy API is a 1-to-1 mapping of the LearnWorlds 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 learner profiles into your Customer Success platform** — Customer Success platforms can pull LearnWorlds user data — including login status, roles, and NPS scores — to build adoption-aware health scores. If key users at an enterprise account haven't engaged with onboarding courses, your platform can automatically flag churn risk. - **Automate B2B seat provisioning from your billing system** — Subscription billing tools can map purchased training licenses to LearnWorlds Groups, automatically assigning group managers and linking course bundles. This eliminates manual fulfillment when a corporate buyer purchases a multi-seat training package. - **Drive compliance training enrollment from your HR platform** — HR and onboarding tools can read LearnWorlds users, groups, and roles to ensure every new hire or contractor is mapped to the correct training cohort. By syncing group membership with your HRIS, you guarantee that role-specific compliance courses are assigned without manual intervention. - **Centralize user directory management across LMS and identity tools** — Identity governance platforms can list and inspect LearnWorlds users and roles to detect access drift — for example, surfacing users who still have admin-level access after a role change. This keeps your customers' LMS permissions aligned with their central directory. - **Enrich CRM contacts with learning engagement data** — Sales and marketing platforms can pull learner profiles from LearnWorlds and map them to CRM accounts via Groups, enabling reps to see which contacts have completed product training and tailor their outreach accordingly. ## What you can build - **Unified learner directory sync** — List and retrieve all LearnWorlds users with their roles, suspension status, tags, and NPS scores, normalized to Truto's Unified User Directory schema for consistent handling across multiple LMS integrations. - **Group-to-account mapping engine** — Automatically map LearnWorlds Groups — including their linked courses and group managers — to company accounts in your product, enabling B2B seat management and cohort-based reporting. - **Role-based access audit dashboard** — Fetch all LearnWorlds roles and cross-reference them against each user's assigned access level to surface permission mismatches and produce compliance-ready audit reports. - **Onboarding health score widget** — Pull user profile data and group membership from LearnWorlds to calculate per-account onboarding completion rates and surface them as an embeddable widget inside your product. - **NPS-aware support routing** — Retrieve a learner's NPS score and comments from their LearnWorlds profile to prioritize support tickets or trigger proactive outreach for detractors. - **Automated deprovisioning alerts** — Periodically poll LearnWorlds user statuses and flag suspended or inactive accounts so your platform can revoke downstream access or notify administrators in real time. ## FAQs ### What authentication method does the LearnWorlds integration use? LearnWorlds uses API key-based authentication scoped to a specific school. Truto manages the credential lifecycle so your end users simply connect their LearnWorlds account through a guided auth flow — no manual token management required. ### Which LearnWorlds resources are available through Truto's Unified User Directory API? Truto currently supports Users (list all and get by ID), Groups (list all and get by ID), and Roles (list all). These map to the Unified User Directory API's Users, Groups, and Roles resources. ### Does Truto handle pagination for LearnWorlds API responses? Yes. Truto abstracts away LearnWorlds' pagination mechanics entirely. You make a single request through the unified API and Truto handles page cursors and result aggregation behind the scenes. ### Can I retrieve custom fields or tags from LearnWorlds user profiles? Yes. The user endpoints return tags and other profile metadata provided by the LearnWorlds API. These are accessible through the unified user object and can be used for filtering or mapping logic in your application. ### Are write operations (create, update, delete) supported for LearnWorlds? The current integration focuses on read operations — listing and retrieving users, groups, and roles. If your use case requires write operations such as creating users or updating group membership, contact Truto to discuss extending the integration. ### How fresh is the data returned from LearnWorlds through Truto? Truto makes live API calls to LearnWorlds by default, so the data reflects the current state of your end user's school at the time of the request. There is no caching layer unless you explicitly configure one.