Create a webhook

Learn how to create a webhook in three steps: the endpoint, the events, then a test.

[Video walkthrough: creating and testing a webhook]

Steps

Go to Admin → Notification Settings → Webhooks (advanced) and click Create webhook.
Endpoint - Enter a Name you'll recognise, like ConnectWise prod. - Enter the Webhook URL. Use an address starting with https://. - Choose the Payload format: JSON (Empath envelope) for most systems, or Slack incoming webhook to post into Slack. Slack is chosen automatically for Slack addresses. - Optionally add a custom header (Header Key and Header Value) if your system needs one.
Events - Tick the events you want: Course assigned, Course completed, Failed knowledge check and/or Content published. - Tick Include personal data (email, name) in payloads only if your system needs learners' names and emails.
Review & Test - Click Test Webhook to send a sample. You'll see the Data Sent and the Data Received from your system. - Click Create.
Copy the Signing secret shown on the last screen and store it safely. You won't be able to see it again.

Your developer needs the signing secret to check that messages really come from Empath. See “Webhook details for your developer”.
If you lose the secret, delete the webhook and create a new one. You'll get a new secret.

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