Best Approach for Multi-Customer Zoom Rooms Webhook URL Integration using Webhook Only App

API and Webhooks Zoom Rooms
1

Hi Team,

We are building an integration that consumes Zoom Rooms webhook notifications (Event type: zoomroom.alert ) for multiple customers.

Our current approach is:

  1. For each customer, we create a separate Webhook Only App in their Zoom account (tenant).
  2. We enable Event Subscription and configure our webhook endpoint URL.
  3. While configuring the webhook URL, we pass a unique customer identifier as a query parameter (for example: https://example.com/webhook?customerId=123).
  4. When Zoom sends the webhook validation request or event notifications, we use the customer identifier to determine the customer context and retrieve the corresponding Secret Token for webhook validation.

Could you please confirm whether this is the recommended approach for supporting multiple customer tenants?

are there any more scalable or best-practice approaches for, Any recommendations from the Zoom team or developers who have implemented similar multi-tenant integrations would be greatly appreciated.

Thank you!

2

Best approach: use a custom header and set your customer ID in it - that way, each time you receive a webhook notification from that specific app, you’ll have the customer ID available from the header.

Thanks,
Naeem Ahmed