Adding Custom User ID to Webhook Payload (customParams)

Hi Team,

I want to add a custom ID for user identification to each form submission so I can track which user submitted the form. I'm currently using a hidden field to store the user ID, but I noticed that all form data is sent in the request body, and there's no clear way to customize the structure of the webhook payload.

I came across a customParams field in the webhook payload, but it's currently empty. Is there any way to populate this customParams field with custom data, such as a user ID from a hidden field?

Any guidance or documentation on how to include custom values in customParams, or otherwise structure the webhook payload, would be greatly appreciated.

Thank you!

Best regards,

Udeep

Hi Udeep,

Thanks for reaching out to us for help. Regarding your question about adding a custom user ID to the webhook payload, currently, Jotform sends all form data, including hidden fields, in the webhook request body. However, the customParams field in the webhook payload is not designed to be populated with custom data like user IDs from hidden fields.

To track user IDs, you can continue using a hidden field in your form to store the user ID. This hidden field's value will be included in the webhook payload along with other form data, allowing you to identify the user who submitted the form.

If you want to customize the webhook payload structure beyond this, it is not supported directly in Jotform at this time.

Let us know if you need further assistance.

Hi Podo,

Thank you for the clarification.

Yes, I understand that the hidden field is included in the request body. However, since all fields are sent in a single serialized JSON payload (rawRequest), I have to manually deserialize and parse through all fields just to extract the custom user ID. This adds extra overhead on my end.

That’s why I was hoping to use the customParams field to send specific identifiers like the user ID in a more direct and accessible way, outside of the raw form data.

Is there any way—through Enterprise customization or support configuration—that the value of a specific field (like the user ID) can be mapped directly into customParams or another dedicated part of the webhook payload?

Appreciate any suggestions or workarounds.

Best regards,

Udeep

Hi Udeep,

Thanks for your follow-up. Currently, Jotform does not support mapping specific field values directly into the customParams field of the webhook payload, even with Enterprise customization. The webhook payload includes all form data in a single JSON object, so extracting specific values requires parsing the payload on your end.

While Enterprise offers advanced features like SAML attribute mapping for SSO prefill, it does not extend to customizing webhook payload structure in this way.

If you need a more direct way to access specific data, you might consider processing the webhook payload with a middleware service that extracts and forwards the desired fields separately.

Hi Udeep,

Thanks for reaching out to Jotform Support. Are you an Enterprise user? If yes, we have a dedicated Enterprise Support Team to help you. We have a guide that explains How to Contact Enterprise Support Team. Create a ticket there and someone from the Enterprise Support Team will get in touch with you shortly.

If not, you can contact our Enterprise team and ask if that is possible on that level. Contacting our Enterprise Sales Team is easy, you'll just need to send a request first, and they'll reach out to you with more information. Let me show you where to find the request form:

1. Go to the Contact Sales page, and fill out the form.
2. Then, click on the Send Request button, and that's it.

Let us know if there’s anything else we can help you with.