Receiving webhooks for more than one company

Technical details for one receiver that handles events from more than one Empath company, for example an MSP automating for several clients.

How do I tell companies apart?

Every payload has a top-level tenantId: the ID of the Empath company the event came from. Route on it.

Other options:

• Create a separate webhook per company, each with its own address, e.g. a path per client.
• Set a custom header on each webhook, e.g. X-Client: acme. See “Create a webhook: the Endpoint step”.

Good to know

• In a test sent from the create wizard, tenantId is the placeholder test-tenant. Tests from a saved webhook carry your real company ID. See “Test deliveries vs live deliveries”.
• Each webhook has its own signing secret. Look up the secret by webhook (or header), not by company alone.

Still need help?

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

Related articles

• Payload reference
• Create a webhook: the Endpoint step