learndash/list-notification-triggers lists the events a notification email can be sent on.
Course enrolment and completion, lesson and topic completion, quiz pass or fail, group enrolment, assignment upload and approval, essay grading, course expiry, and learner inactivity.
At a glance
| Ability | learndash/list-notification-triggers |
| 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
Two of those are worth singling out because they are the ones sites forget they can use.
Course expiry fires before or as access ends, which is the only warning a learner gets that a time-limited course is about to close. A site with expiring access and no expiry notification loses learners silently.
Learner inactivity fires when somebody stops progressing, which is the re-engagement trigger — and the one most likely to be misconfigured, because “inactive” has to be defined somewhere.
Assignment upload and approval are a pair: one tells the administrator something needs marking, the other tells the learner it was marked. A site with the first and not the second leaves learners waiting without knowing they can proceed.
Use one of these keys as the trigger when creating a notification.
Input
This ability takes no input.
What comes back
| Name | Type | What it is |
|---|---|---|
triggers | array | Each trigger key with the event it responds to. |
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 can we send learners emails about?
It resolves to one call:
{
"ability": "learndash/list-notification-triggers",
"parameters": {}
}Worth knowing
- Course expiry is the only warning before time-limited access ends.
- Inactivity is the re-engagement trigger.
- Assignment upload and approval are a pair — having one without the other strands learners.
- Read-only.
Related abilities
- LearnDash Manage Notification — use one
- LearnDash List Notifications — what already fires
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category