How to merge data with form_fields_per_document

Updated Sep 29, 2025

In this article

When using form_fields_per_document to place signer fields, you can use the custom_fields parameter to merge data into the text fields.

For the form fields, specify "type": "text-merge" as noted in these Field Types and include the "name" as well.

Using the name of the field, pass the data for the field using the custom_fields parameter.

Example cURL parameters:

-F 'form_fields_per_document=[[{"name": "Name of text field", "type": "text-merge", "x": 160, "y": 80, "width": 206, "height": 32, "signer": 0}]]' \
-F 'custom_fields=[{"name": "Name of the text field", "value": "This data will show up in the text box"}]'
Was this article helpful?

Let us know how why it didn't help:

Thanks for letting us know!

Thanks for your feedback!

Community answers

Other ways to get help