Skip to content
English
Contact us
  • There are no suggestions because the search field is empty.

What Empath webhooks are for

Learn what Empath webhooks send, typical ways MSPs use them, and when a webhook is the right tool.

This article explains what Empath webhooks send and the jobs they're typically used for.

What are Empath webhooks for?

Use webhooks when you want your tools to know what happened to your people in Empath, without anyone forwarding emails.

When a training event you've subscribed to happens, Empath sends a signed HTTP POST with a small JSON body to an address you control. Your system decides what to do with it.

Typical jobs

  • A ticket when someone is assigned training — Subscribe to: Course assigned (course.assigned) · Then, in your system…: Open a work item for that person (or their manager).
  • That ticket to close when they finish — Subscribe to: Course completed (course.completed) · Then, in your system…: Match on the Empath user and course, and close it.
  • A flag when someone is stuck on a quiz — Subscribe to: Failed knowledge check (knowledge_check.failed) · Then, in your system…: Open or bump a coaching item.
  • Your team to know new content is live — Subscribe to: Content published (content.published) · Then, in your system…: Notify your content or ops team. This isn't about a person, so there's no user in it.

If you only care about people, subscribe to the first three and skip Content published.

Good to know

  • Webhooks are immediate. They're never held for the email digest.
  • Each event sends one POST to each webhook subscribed to it. Content published sends one per webhook for your whole company, not one per person.
  • You can also send messages straight to Slack. See “Send webhook events to Slack”.
  • If your PSA already turns emails into tickets, sending a copy to a shared inbox (on Notification types) may be simpler. That's how manager emails such as the weekly team report reach a PSA, because the weekly report isn't a webhook event.

Still need help?

Reach out to your Partner Success Manager, or email us at support@empathmsp.com. We’re happy to help!

Related articles

  • What webhooks won't tell you
  • Before you start
  • The four events and when they're sent