How to request a signature field for each recipient when creating an envelope

Question

I have setup the docusign API on my app. Everything is working but I can't find in the docusign documentation how to request at least a Signature field in the envelope for each recipient. Today the sender can send the envelope without adding any field the envelope...

Answer 1

Envelopes can be sent to recipients without tabs (or tags or fields) so that the recipient (signer) then has to drag-and-drop fields to the envelope. That is called "free-form" signing and appears to n ot be what you want .

To add tabs to the envelope you have to modify your API calls to include these elements. They relate to recipients so are nested under them in the JSON like this:

"recipients": {
         "signers": [
            {
                "email": "'"${SIGNER_EMAIL}"'",
                "name": "'"${SIGNER_NAME}"'",
                "recipientId": "1",
                "routingOrder": "1",
                "clientUserId": "1000",
                "tabs": {
                    "signHereTabs": [
                        {
                            "anchorString": "/sn1/",
                            "anchorUnits": "pixels",
                            "anchorXOffset": "20",
                            "anchorYOffset": "10"
                        }
                    ]
                }
            }
        ]

The above uses anchor strings , but you can also position then using fixed position with xPosition, yPosition, pageNumber and documentId .

You can find the full code example in 8 languages in the DocuSign Developer Center.