Enroll an iSpring Learn department in a course

1. An administrator opens Learning Content, Courses, picks the course and clicks Enroll Users in the top menu, or opens the course's Edit Course page and its Enrollments tab.
2. The wizard runs Courses, Users, Parameters. On Users the administrator uses Advanced Search to pick a department, a group or a profile field such as position or country.
3. On Parameters the administrator sets the start date and one of four due date options: Use course settings, By Date, For a period or No Due Date, and may tick Restrict access after due date.
4. After Enroll, learners get a notification in the user portal and by email, and the course shows in My Courses.
5. Nothing in the wizard repeats for the next team: the administrator opens it again, and the course's Enrollments tab is the only place to check who already had it.

Enroll everyone in the Sales department who is not yet in Information Security Basics. Start on 2 November, due 30 November, and list who you skipped.

1. 01

   Find the department

   Your agent calls list_departments with the name from your prompt and takes its department_id. If two departments match, it asks which one before touching anyone. A Department Administrator sees only the departments they manage, so a department outside that list is not found.

2. 02

   List the people who can be enrolled

   list_users runs with that department_id and status active. Inactive users are left out on purpose: iSpring Learn does not let an inactive user be assigned to a course.

3. 03

   Skip who already has the course

   list_enrollments for the course gives everyone already enrolled, whatever their status. The agent removes them from the list, so nobody gets a second enrollment or a fresh start date over their progress.

4. 04

   Pick the dates

   The agent passes start_date and due_mode from your prompt. With no dates it uses use_course_settings, which takes the due date from the Availability tab of the course. A month counts as 30 days and a year as 365, so "for 2 months" is 60 days.

5. 05

   Enroll once

   enroll_users sends one call for the whole list and waits for your OK by default. The agent then reports who was enrolled and who was skipped, with the reason.

Information Security Basics, Sales department
Enrolled 12, start 2 Nov 2026 09:00, due 30 Nov 2026
Skipped 5 (already enrolled)
Skipped 2 (inactive accounts)
Learners were notified in the portal and by email

curl -X POST https://cotlet.dev/api/v1/ispring/users/enroll \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"course_ids":["c_4f2a91"],"user_ids":["u_81c2d4","u_81c2e9"],"start_date":"2026-11-02T09:00","due_mode":"by_date","due_date":"2026-11-30"}'

{
  "enrolled": 2,
  "enrollments": [
    {
      "enrollment_id": "e_70a1b3",
      "user": "Ana Lopez",
      "course": "Information Security Basics",
      "start_date": "2026-11-02T09:00:00",
      "due_date": "2026-11-30T00:00:00"
    },
    {
      "enrollment_id": "e_70a1b4",
      "user": "Tom Becker",
      "course": "Information Security Basics",
      "start_date": "2026-11-02T09:00:00",
      "due_date": "2026-11-30T00:00:00"
    }
  ]
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is ispring_write → enroll_users. Example data.

• Deactivate iSpring Learn accounts of leavers
• iSpring Learn (iSpring LMS) API and MCP server: every tool
• All use cases