Before you start
Learn who can set up webhooks, what must be switched on, and what to prepare before you create your first webhook.
Learn what you need before you create your first Empath webhook.
What do I need?
- The right role. Only managers and admins in Empath can create, edit, test or delete webhooks. Content admins can view the tab but can't change it.
- Webhook delivery on for your company. If the Webhooks tab shows Webhook delivery is not enabled for your account yet, contact your Partner Success Manager.
- A receiver. An HTTPS address that accepts
POSTrequests and answers within 10 seconds. See “Request format: method, headers and timeouts”. - A way to identify people. Either a mapping from Empath user IDs to your own records, or the personal-data option (email and name). See “Identify people: user IDs or personal data”.
- Somewhere safe for the signing secret. You'll see it only once, when you create the webhook.
Where to find it
Go to Admin → Notification Settings and open the Webhooks (advanced) tab.
[Screenshot: the Webhooks (advanced) tab with one webhook]
Good to know
- There's no limit on the number of webhooks. Many teams create one per destination system, e.g. PSA — training tickets and Slack — #training.
Still need help?
Reach out to your Partner Success Manager, or email us at support@empathmsp.com. We’re happy to help!
Related articles
- Create a webhook: the Endpoint step
- Request format: method, headers and timeouts
- Go-live checklist