Identify people: user IDs or personal data
Learn how Empath webhooks identify people, and choose between matching on Empath user IDs or including email and name.
Learn how webhooks identify the person an event is about, and how to match them to your own records.
How is a person identified?
Every event about a person includes data.user. What's in it depends on one option you choose when you set up the webhook: Include personal data (email, name) in payloads.
- On — You get:
id,email,displayName· You need: Nothing extra. Match on email to your PSA contact or directory user. Treat this as personal data under your privacy agreements. - Off — You get:
idonly · You need: A mapping table from Empath user ID to your own record, built before go-live.
Content published has no data.user.
Good to know
- The Slack format includes only the person's name, and only when personal data is on. See “Send webhook events to Slack”.
- You can change this option later with Edit webhook. It applies to events sent after the change.
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 Events step
- Payload reference
- Receiving webhooks for more than one company