Merge Fields

Signeasy's API allow to prefill textual information on Templates before sending them out to your signers. This can be a perfect usecase where your signers would are expecting to see specific information on your document before signing.

Setting up Merge Label

Step 1: Login to your Signeasy account
Step 2: Create/Edit a Template
Step 3: Add a Text Field and when selecting the role, choose Me(while sending)


Step 4: Choose an appropriate name for your Merge Label, note that this place will be displayed with the value you set in the API request.


Assigning the value to the Merge Label

Step 1: Once you've set up the labels in your template you can map those labels to a value in the API request.

Step 2: You can assign value to this label in the API request on our Envelope API

The syntax for setting a value for a label looks like this.

merge_fields: [{
label: "mergeLabel",
value: "value of the label",
source_id: 1

Sample Request of Merge Fields in an API request

curl --location --request POST '' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "embedded_signing": true,
    "sources": [{
        "source_id": 1,
        "type": "template",
        "id": 1234567
    "is_ordered": 0,
    "recipients": [{
        "first_name": "John",
        "last_name": "Doe",
        "email": "[email protected]",
        "recipient_id": 1
    "message": "API TESTING",
    "merge_fields": [
            "label": "employeeId", // merge field label
            "value": "JOHN1234", // merge field value
            "source_id": 1
    "recipient_role_mapping": [{
        "role_id": 1,
        "recipient_id": 1,
        "source_id": 1