MindTickle — Course & Module Management

Overview

Primary workflow for MindTickle sales readiness integration. Covers end-to-end course management: creating training modules with mixed content (video, quiz, document), assigning courses to individuals or teams with due dates and reminders, tracking completion and quiz scores via the analytics API, and updating modules as content evolves. Uses the MindTickle REST API with API key authentication. All list endpoints support cursor-based pagination for large organizations.

Instructions

Step 1: Create a Course with Modules

const course = await client.courses.create({
  title: 'Q2 Product Launch Readiness',
  description: 'Everything your team needs to sell the new platform tier',
  tags: ['product-launch', 'q2-2026'],
  modules: [
    { title: 'Overview', type: 'video',
      url: 'https://videos.example.com/q2-launch.mp4', duration_min: 12 },
    { title: 'Feature Deep Dive', type: 'document',
      url: 'https://docs.example.com/q2-features.pdf' },
    { title: 'Knowledge Check', type: 'quiz', questions: [
      { text: 'What is the key differentiator?', type: 'multiple_choice',
        options: ['Speed', 'Price', 'Integration'], correct: 2 },
      { text: 'Name one target persona.', type: 'free_text' },
    ]},
  ],
});
console.log(`Course created: ${course.id} with ${course.modules.length} modules`);

Step 2: Assign Learners

const assignment = await client.assignments.create({
  course_id: course.id,
  assignees: { type: 'team', team_ids: ['team_sales_west', 'team_sales_east'] },
  due_date: '2026-06-01',
  reminder: { enabled: true, days_before: [7, 3, 1] },
  late_policy: 'allow_completion',
});
console.log(`Assigned to ${assignment.assignee_count} learners`);

Step 3: Track Progress and Scores

const progress = await client.analytics.courseProgress(course.id);
progress.users.forEach(u =>
  console.log(`${u.name}: ${u.completion}% | Quiz: ${u.quiz_score ?? 'N/A'}`)
);
console.log(`Overall: ${progress.completion_rate}% | Avg score: ${progress.avg_score}`);

Step 4: Update Module Content

await client.modules.update(course.modules[0].id, {
  url: 'https://videos.example.com/q2-launch-v2.mp4',
  duration_min: 15,
});
console.log('Module updated — learners will see new content on next access');

Error Handling

401 Unauthorized

X-Api-Key

404 Not Found

409 Conflict

422 Validation Error

correct

429 Rate Limited

Retry-After

Output

A successful run creates a course with video, document, and quiz modules, assigns it to sales teams with reminders, and reports completion rates and average quiz scores.

Resources

• MindTickle Platform Integrations
• MindTickle API Reference

Next Steps

Continue with

mindtickle-core-workflow-b