The four events and when they're sent
Technical details of the four Empath webhook events, exactly what triggers each one, and what each payload identifies.
Technical details of the four events Empath can send. The JSON type field is what you switch on. It's also sent as the X-Empath-Event header.
Which events are there?
- Course assigned — type:
course.assigned· Sent when: A course is assigned to someone. · Identifies: The person and the course - Course completed — type:
course.completed· Sent when: Someone completes a course for the first time, from any source: Empath's player, SCORM, AICC, Microsoft Learn or a manual "mark complete". · Identifies: The person and the course - Failed knowledge check — type:
knowledge_check.failed· Sent when: Someone submits a knowledge check and doesn't pass. Passes never send. · Identifies: The person and the knowledge check (usually no title) - Content published — type:
content.published· Sent when: A course, knowledge check or pathway goes from draft to published. · Identifies: The content only. There's no person.
In the create wizard these appear under Assignments & due dates, Completions & knowledge checks and New content.
Good to know
- Course completed fires on the first completion only. Completing the same course again, or background corrections to progress, don't send it again.
- Course assigned doesn't include the due date. See “What webhooks won't tell you”.
- Content published always has
data.object.type=content, whether it was a course, knowledge check or pathway. - Resetting someone's progress doesn't send any webhook.
Still need help?
Reach out to your Partner Success Manager, or email us at support@empathmsp.com. We’re happy to help!
Related articles
- How often an event can repeat
- Identify people: user IDs or personal data
- Payload reference