create_user_group
Create a new user group in LearnWorlds with a title and courses, plus optional tags, managers, and enrollment rules.
Instructions
🟡 WRITE · creates data · POST /v2/user_groups
Creates a new user group. The endpoint response is the created user group resource.
Behavior: creates a record or triggers an action in the live school. Not idempotent: a repeated call can duplicate the effect. Auth (admin API token + Lw-Client id) is injected server-side, never by the model; calls are throttled to stay under LearnWorlds' 30-per-10s cap and retried on 429/5xx.
Parameters: the whole JSON payload goes in the single body argument, forwarded verbatim (the spec leaves body optional, but this endpoint expects one).
Returns: HTTP <status> followed by the LearnWorlds JSON response body. A non-2xx reply surfaces as a tool error with that status and the API error payload — 401 bad/expired token, 403 not permitted, 404 no such record, 422 rejected input.
Use when: only when the user asked to create this. Check with a 🟢 read tool that the target exists and the record is not already there. Related User groups tools: add_user_user_group, deletes_user_group, get_user_group, get_user_groups, get_users_user_group.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | Request body (application/json). |