topic Re: Can't add query param to Webhook URL in Integration and Testing

Can't add query param to Webhook URL

lilistoyanovamn — Fri, 29 May 2026 14:37:20 GMT

Hi,

I'm configuring a webhook for a Salesforce commerce integration but I get an error when trying to add query params to the webhook URL. The merchant portal rejects:

/services/data/vNN.0/commerce/payments/notify?provider=<paymentGatewayProviderId>

The receiving platform requires a query string for routing, and the value isn't a secret.

Questions:

Is there a way to add a webhook URL with a query string?
If not is there an officially recommended pattern for integrating with platforms whose webhook receivers require query parameters?

Thanks!

Re: Can't add query param to Webhook URL

muhammadammar23 — Fri, 05 Jun 2026 07:10:24 GMT

It sounds like webhook URLs may not support query parameters. If that's the case, the recommended approach is usually to use an intermediary endpoint or pass the required value through the request body, headers, or URL path instead of a query string. It would be helpful if Salesforce could clarify the officially supported pattern for this scenario.

Re: Can't add query param to Webhook URL

hunzafatimaa — Fri, 05 Jun 2026 15:07:30 GMT

Webhook URLs appear to reject query parameters. If query strings are not supported, consider using a dedicated endpoint, request headers, or the request body to pass the provider identifier. Another option is to use an intermediary endpoint that receives the webhook and forwards it with the required query parameter. Can Salesforce confirm the recommended approach for integrations that require query-string routing?