Create a webhook: the Endpoint step

Learn how to start a new webhook and complete the first of its three steps.

[Video walkthrough: creating a webhook]

How do I start a webhook?

Go to Admin → Notification Settings → Webhooks (advanced).
Click Create webhook. The wizard has three steps: Endpoint, Events and Review & test.

Name: something that says where it goes, e.g. PSA — training tickets (up to 120 characters).
Webhook URL: your receiver's address (up to 2,048 characters). Use https://.
Payload format: - JSON (Empath envelope) for your own receiver, a PSA integration or an automation tool. - Slack incoming webhook to post into a Slack channel. This is chosen automatically for Slack addresses. See “Send webhook events to Slack”.
Optionally, Header key (optional) and Header value (optional): one extra header sent with every request, e.g. a token your receiver checks.
Continue to Events. See “Create a webhook: the Events step”.

Empath doesn't follow redirects. Enter the final address; a 3xx answer counts as a failure.
Addresses on private networks, local addresses and cloud metadata addresses can be saved, but every delivery to them fails.
Empath's own headers can't be replaced by your custom header: X-Empath-*, Content-Type, Host, Content-Length, Connection and Transfer-Encoding. A custom header with one of these names is silently not sent.

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