learndash/list-notifications lists the notification emails configured on this site, each with the event that fires it, who receives it, any object it is scoped to, and its send delay.
The status is reported because a notification only sends while published.
At a glance
| Ability | learndash/list-notifications |
| Toolset | LearnDash — toolset/learndash |
| Group | LearnDash › Notifications |
| Requires | AcrossAI Pro, plus LearnDash LMS active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
How it works
A draft notification is inert. That is the same trap as draft achievements, and it is more common here because notifications are often written in advance.
Filtering by trigger shows everything firing on one event, which is how you find out that course completion sends four emails — one to the learner, one to the admin, one to the group leader and one somebody added and forgot.
Scope narrows a notification to a specific course, lesson, topic, quiz or group. An empty scope means it fires for all of them, which is the setting most likely to have been left unintentionally broad.
The send delay is what turns an immediate email into a follow-up — “three days after enrolment” rather than “on enrolment”.
learndash/get-notification returns the body, which this listing omits because it is long and full of shortcodes.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
trigger | string | No | Only notifications firing on this event. |
per_page | integer | No | Rows per page. |
What comes back
| Name | Type | What it is |
|---|---|---|
notifications | array | Each with its trigger, recipient, scope, delay and status. |
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:
What emails does this site send learners?
It resolves to one call:
{
"ability": "learndash/list-notifications",
"parameters": {}
}Worth knowing
- A draft notification never sends.
- An empty scope means it fires for every course.
- Filter by trigger to find everything firing on one event.
- The body is a separate call.
Related abilities
- LearnDash Get Notification — the body and shortcodes
- LearnDash List Notification Triggers — the events
- LearnDash Manage Notification — create one
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category