learndash/manage-group creates a new group or updates an existing one.
A new group is inert: it grants nothing until courses are assigned, and has nobody in it until members are added.
At a glance
| Ability | learndash/manage-group |
| Toolset | LearnDash — toolset/learndash |
| Group | LearnDash › Groups |
| Requires | AcrossAI Pro, plus LearnDash LMS active on the site |
| Capability | manage_options |
| Safety | Writes data |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
How it works
Those are learndash/manage-group-courses and learndash/manage-group-membership, and both are separate because both are incremental operations that can be run repeatedly as a cohort changes.
So a working group is three kinds of call, and a group that exists and grants nothing is a normal intermediate state.
The settings mirror a course’s. group_price_type and group_price make the group purchasable — buying a group is how LearnDash sells a bundle of courses as one product.
group_courses_auto_enroll decides whether joining enrols members in the courses or merely grants access, which affects how their progress records are created.
certificate names a template issued on completing the group as a whole, which is separate from any per-course certificate.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
action | string | Yes | create or update. |
group_id | integer | For update | Which group. |
title | string | For create | The group title. |
content | string | No | The group description. |
status | string | No | Post status. |
settings | object | No | LearnDash group settings. |
What comes back
| Name | Type | What it is |
|---|---|---|
group | object | The group after the write. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Create a group for the January cohort.
It resolves to one call:
{
"ability": "learndash/manage-group",
"parameters": {
"action": "create",
"title": "January 2026 cohort"
}
}Worth knowing
- A new group grants nothing and contains nobody.
- Groups can be sold, which is how course bundles work.
- A group certificate is separate from per-course certificates.
- Idempotent.
Related abilities
- LearnDash Manage Group Courses — what it grants
- LearnDash Manage Group Membership — who is in it
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category