# LearnWorlds + Lutril: setup guide

> Lutril needs your school's API Client ID and Client Secret, plus the school domain. It mints its own short lived access token, so there is no token to create or rotate by hand. A tag (Employees by default) keeps the roster to the people you govern instead of every learner in the school.

Source: https://www.lutril.com/integrations/learnworlds
Category: Productivity
Auth: api_key
Last verified: 2026-10-22

---

## Setup

1. [object Object]
2. On the same page, use Copy the API URL. The part before /admin/api is your school domain, for example acme.learnworlds.com.
3. Skip the Access Tokens section. Lutril exchanges the Client ID and Secret for a token on every call and refreshes it on its own.
4. In Lutril, connect LearnWorlds and paste the school domain, Client ID and Client Secret.
5. Leave the User Tag as Employees, or set it to whichever tag marks your staff. LearnWorlds matches it exactly as written, capitalisation included, so copy it from the school. Clearing it lists the whole school, learners and customers included.

## Access requested

- API Client ID and Client Secret (school administrator credentials)
- Users: read, create, suspend and unsuspend
- User roles: read and assign

## References

- [LearnWorlds documentation](https://www.learnworlds.dev/docs/api/b6b6c2d4906e9-authentication)
- [API reference (users, roles, suspend)](https://www.learnworlds.dev/docs/api/54f1031d0ddba-get-all-users)
- [Suspending a user: what it resets](https://www.learnworlds.dev/docs/api/80dee586e1ba1-suspend-a-user)