docusignapi - Signers vs Recipients -

we integrating our bpm application docusign. have document should signed n individuals. should have multiple recipient tags or 1 recipient tag multiple signer tags inside that? difference between both approaches?

each recipient object has properties identify specific signer including property represents signer's name, example). "create envelope" api request need include separate recipient object each signer -- , then, each recipient, you'll specify tags belong recipient. (the other approach describe -- i.e., facilitating multiple people signing envelope specifying 1 recipient multiple 'sign here' tags -- not feasible under circumstances.)

for example, recipients structure represents 2 signers, each having 1 place sign , 1 text box complete, this:

"recipients": {   "signers": [    {       "name": "john doe",       "email": "johnsemail@outlook.com",       "recipientid": "1",       "routingorder": "1",       "clientuserid": "123",       "tabs":{             "signheretabs":[                 {                     "tablabel":"bsign1",                     "documentid": "1",                      "pagenumber": "1",                      "xposition": "200",                      "yposition": "200"                 }             ],             "texttabs":[                {                     "tablabel":"borrowerphone",                     "value":"717-717-7171",                     "documentid": "1",                      "pagenumber": "1",                      "xposition": "100",                      "yposition": "100"                }             ]          }     },     {       "name": "jane doe",       "email": "janesemail@outlook.com",       "recipientid": "2",       "routingorder": "2",       "clientuserid": "567",       "tabs":{             "signheretabs":[                 {                     "tablabel":"cbsign1",                     "documentid": "1",                      "pagenumber": "2",                      "xposition": "200",                      "yposition": "200"                 }             ],             "texttabs":[                {                     "tablabel":"co-borrowerphone",                     "value":"111-222-3333",                     "documentid": "1",                      "pagenumber": "2",                      "xposition": "100",                      "yposition": "100"                }             ]          }     }   ] } 

taking time review information (and code samples) on docusign developer center (https://www.docusign.com/developer-center) , within rest api guide (https://10226ec94e53f4ca538f-0035e62ac0d194a46695a3b225d72cc8.ssl.cf2.rackcdn.com/rest-api-guide-v2.pdf) time spent.