Issue Registering Multiple Webhooks with Different Target URLs in HubSpot

[Storeganise]

Hi HubSpot Support Team,

We are developing a SaaS application that integrates with HubSpot and listens for webhook events from different businesses that install our app.

Each business that installs our app has unique credentials, and we need to process webhook events differently for each business.

Problem Statement:
We need to register multiple webhooks in HubSpot, where each webhook should have a different targetUrl. However, based on the API documentation and testing, it appears that HubSpot allows only one webhook configuration per app.
Our expected behavior is:

• Each business that installs our app should have a different webhook target URL.
• The targetUrl should include dynamic parameters to help us identify which business sent the webhook.
  • Example: https://our-saas-app.com/webhook/{businessCode}~{addonId}
• When a webhook event is triggered, we need to fetch the business-specific credentials and process the event accordingly.

Challenges Faced:

1. Unable to Register Multiple Webhooks with Different Target URLs
   • We attempted to call the PUT /webhooks/v3/{appId}/settings API multiple times with different targetUrl values, but only one webhook configuration is stored at a time.
   • The latest PUT request overwrites the existing webhook settings instead of creating a new webhook.
2. No Clear Way to Dynamically Pass Business Identifiers
   • We do not maintain a database to store portalId or other HubSpot-related identifiers.
   • Is there a way to include custom fields in webhook requests that we can configure via API calls?
   • Can we utilize portalId or companyId (are they the same?) to differentiate businesses?
3. How to Handle Multi-Tenant Webhooks Efficiently?
   • Since our app is installed by multiple businesses, we need a way to differentiate webhook events between businesses.
   • Is there a HubSpot-recommended best practice for handling multi-tenant webhook integrations?

Questions for HubSpot Support:

1. Does HubSpot support registering multiple webhooks with different targetUrls for a single app?
2. Is there a way to dynamically pass business-specific identifiers in webhook payloads?
3. What is the recommended approach for handling webhooks in a multi-tenant SaaS app where different businesses install the same HubSpot app?
4. Is there any workaround or best practice to handle our use case efficiently?

Any guidance or best practices from the HubSpot team would be highly appreciated.
Looking forward to your response!

Best regards,
Team Storeganise

[Jaycee_Lewis]

Hey, @Storeganise 👋 Thanks for your question. To set the correct expectations, this is a peer-to-peer support forum where answers are provided by other community members. HubSpot Product and Engineering folks do not answer questions in this forum. We'll leave this open for other community members to view. Thanks! — Jaycee

[Storeganise]

Yes, noted