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.
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`);
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`);
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}`);
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');
| Issue | Cause | Fix |
|---|---|---|
401 Unauthorized |
Invalid or missing API key | Verify X-Api-Key header value |
404 Not Found |
Course or module ID invalid | Confirm IDs from create responses |
409 Conflict |
Duplicate course title in org | Use unique title or update existing |
422 Validation Error |
Quiz missing correct answer | Ensure every MC question has correct index |
429 Rate Limited |
Exceeds 60 req/min | Implement retry with Retry-After header |
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.
Continue with mindtickle-core-workflow-b for coaching and role-play scenarios.