Skip to main content
Newcomer
April 30, 2024
Solved

Multiple recipients - need help on adding the multiple recipients on a envelop

  • April 30, 2024
  • 2 replies
  • 257 views

Hello,

 

Below is the request payload for which I’m trying to create an envelope and send it to multiple signers, but the problem is creating the envelope with a single signer.

{
  "documents": [
    {
      "documentBase64":"JVwj===" ,
      "documentId": "1",
      "fileExtension": "pdf",
      "name": "EmploymentContractDocuSign.pdf"
    }
  ],
  "emailSubject": "Kindly review and sign the employment contract document for Person: Test 002.2:47",
  "recipients": {
    "signers": [
      {
        "email": "test@gmail.com",
         "name": " kj",
         "recipientId": "22",
         "routingOrder": "2",
         "isBulkRecipient": true
      }
    ],
    "signers": [
      {
        "email": "Test002@yopmail.com",
         "name": "Test",
         "recipientId": "11",
         "routingOrder": "1",
         "isBulkRecipient": true
      }
    ]
  },
  "status": "sent"
}

    Best answer by Jonathan.Sammons

    Hello Kishor,

    If you’re just trying to create an envelope with a single signer, you could make a call using this example payload:

    {
    "status": "sent",
    "emailSubject": "This is a custom email subject.",
    "emailBlurb": "This is a custom email blurb.",
    "documents": [{
    "documentId": "1",
    "name": "TestDocument.docx",
    "fileExtension": "docx",
    "documentBase64": "UEsDBBQABgAIAAAAIQDfpN..."
    }
    ],
    "recipients": {
    "signers": [{
    "name": "John Doe",
    "email": "john.doe@email.com",
    "recipientId": "1",
    "tabs": {
    "signHereTabs": [{
    "xPosition": "25",
    "yPosition": "50",
    "documentId": "1",
    "pageNumber": "1"
    }
    ]
    }
    }
    ]
    }
    }

    This example has a single signer with a single sign here tab assigned to them. I also noticed that you have ‘isBulkRecipient’ applied to your recipients - I would recommend removing this unless you’re using bulk send as well.

     

    Best regards,

    Jonathan | Docusign Developer Support

    2 replies

    Alexandre.Augusto
    Docusign Employee
    Docusign Employee
    April 30, 2024

    Hello, @KishorJayanna 

     

    Welcome to the Docusign Community!

     

    Have you seen our API resources? For example, this one:
    https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopes/create/

     

    Also, this video show step by step how to create/send an envelope via API:
     

     

    You can find many examples about how to send an envelope accordingly the programming language at the GitHub site.

     

    Let me know if I answered your question.

     

    Best,

    Alexandre

    Your feedback is very appreciated! You can give a Like and mark this answer as the "Best Answer" for your issue. DocuSign University http://dsucustomers.docusign.com
    Docusign Employee
    May 1, 2024

    Hello Kishor,

    If you’re just trying to create an envelope with a single signer, you could make a call using this example payload:

    {
    "status": "sent",
    "emailSubject": "This is a custom email subject.",
    "emailBlurb": "This is a custom email blurb.",
    "documents": [{
    "documentId": "1",
    "name": "TestDocument.docx",
    "fileExtension": "docx",
    "documentBase64": "UEsDBBQABgAIAAAAIQDfpN..."
    }
    ],
    "recipients": {
    "signers": [{
    "name": "John Doe",
    "email": "john.doe@email.com",
    "recipientId": "1",
    "tabs": {
    "signHereTabs": [{
    "xPosition": "25",
    "yPosition": "50",
    "documentId": "1",
    "pageNumber": "1"
    }
    ]
    }
    }
    ]
    }
    }

    This example has a single signer with a single sign here tab assigned to them. I also noticed that you have ‘isBulkRecipient’ applied to your recipients - I would recommend removing this unless you’re using bulk send as well.

     

    Best regards,

    Jonathan | Docusign Developer Support