Skip to content
  1. Blog
  2. API

How to Send a Document to Multiple Signers with the BoldSign API

TL;DR: You can send one document to several signers with a single BoldSign API call. List each signer in the request, give each one their own signature fields, and listen for webhook events to confirm the request went out. Our eSignature API page shows what else the API can do.

A partnership agreement needs signatures from your client, their finance lead and your own manager. You could send three separate requests, but then you track three documents for one deal.

One request with three signers keeps everything in a single document. This guide shows how to list multiple signers, place fields for each one and check that the request was sent. The official Send document to multiple recipients guide has the same samples.

What does sending to multiple recipients mean?

Sending to multiple recipients means one signature request that goes to several people at once. Every recipient opens the same document and completes only the fields that belong to them.

Think of a birthday card passed around an office. There is one card, and each person signs in their own space. Our electronic signature API works the same way, with a signature field for each signer.

How do you send a document to multiple signers with the BoldSign API?

Add one Signers entry per person to a single request to the send endpoint. Each entry holds a name, an email address, a signer type and the form fields that person must complete.

  1. Get your API key and the file you want signed.
  2. Create a signature field for each signer, with a page number and position.
  3. Add each signer with their name, email address and their own fields.
  4. Send the request to https://api.boldsign.com/v1/document/send with a title and the file.

The samples below send one document to two signers, Alex and Sam. Alex signs on page 1, and Sam signs on page 2.

curl -X 'POST' \
  'https://api.boldsign.com/v1/document/send' \
  -H 'accept: application/json' \
  -H 'X-API-KEY: {YOUR_API_KEY}' \
  -H 'Content-Type: multipart/form-data' \
  -F 'Message=' \
  -F 'Signers={
  "name": "Alex",
  "emailAddress": "alex@example.com",
  "signerType": "Signer",
  "formFields": [
    {
      "id": "Signature1",
      "fieldType": "Signature",
      "pageNumber": 1,
      "bounds": {
        "x": 50,
        "y": 50,
        "width": 200,
        "height": 25
      },
      "isRequired": true
    }
  ],
  "locale": "EN"
}' \
  -F 'Signers={
  "name": "Sam",
  "emailAddress": "sam@example.com",
  "signerType": "Signer",
  "formFields": [
    {
      "id": "Signature2",
      "fieldType": "Signature",
      "pageNumber": 2,
      "bounds": {
        "x": 100,
        "y": 100,
        "width": 200,
        "height": 25
      },
      "isRequired": true
    }
  ],
  "locale": "EN"
}' \
  -F 'Files=@{YOUR_FILE_PATH}' \
  -F 'Title={DOCUMENT_TITLE}'
var apiClient = new ApiClient("https://api.boldsign.com", "YOUR_API_KEY");
var documentClient = new DocumentClient(apiClient);

var documentFilePath = new DocumentFilePath
{
    ContentType = "application/pdf",
    FilePath = "FILE_PATH",
};

var filesToUpload = new List<IDocumentFile> { documentFilePath };

var signatureField = new FormField(
    id: "Signature1",
    isRequired: true,
    type: FieldType.Signature,
    pageNumber: 1,
    bounds: new Rectangle(x: 50, y: 50, width: 200, height: 25));

var signatureField1 = new FormField(
    id: "Signature2",
    isRequired: true,
    type: FieldType.Signature,
    pageNumber: 2,
    bounds: new Rectangle(x: 100, y: 100, width: 200, height: 25));

var signer = new DocumentSigner(
    signerName: "Alex",
    signerType: SignerType.Signer,
    signerEmail: "alex@example.com",
    formFields: new List<FormField> { signatureField },
    locale: Locales.EN);

var signer1 = new DocumentSigner(
    signerName: "Sam",
    signerType: SignerType.Signer,
    signerEmail: "sam@example.com",
    formFields: new List<FormField> { signatureField1 },
    locale: Locales.EN);

var sendForSign = new SendForSign
{
    Title = "DOCUMENT_TITLE",
    Signers = new List<DocumentSigner> { signer, signer1 },
    Files = filesToUpload,
};

var documentCreated = documentClient.SendDocument(sendForSign);
import boldsign

configuration = boldsign.Configuration(api_key="YOUR_API_KEY")

with boldsign.ApiClient(configuration) as api_client:
    api = boldsign.DocumentApi(api_client)

    field1 = boldsign.FormField(
        id="Signature1",
        fieldType="Signature",
        pageNumber=1,
        bounds=boldsign.Rectangle(x=50, y=50, width=200, height=25),
        isRequired=True,
    )

    field2 = boldsign.FormField(
        id="Signature2",
        fieldType="Signature",
        pageNumber=2,
        bounds=boldsign.Rectangle(x=100, y=100, width=200, height=25),
        isRequired=True,
    )

    signer1 = boldsign.DocumentSigner(
        name="Alex",
        emailAddress="alex@example.com",
        signerType="Signer",
        formFields=[field1],
        locale="EN",
    )

    signer2 = boldsign.DocumentSigner(
        name="Sam",
        emailAddress="sam@example.com",
        signerType="Signer",
        formFields=[field2],
        locale="EN",
    )

    send = boldsign.SendForSign(
        title="DOCUMENT_TITLE", signers=[signer1, signer2], files=["FILE_PATH"]
    )

    document_created = api.send_document(send_for_sign=send)
import { DocumentApi, DocumentSigner, FormField, Rectangle, SendForSign } from "boldsign";
import * as fs from "fs";

async function main() {
  const api = new DocumentApi();
  api.setApiKey("YOUR_API_KEY");

  const rect1 = new Rectangle();
  rect1.x = 50;
  rect1.y = 50;
  rect1.width = 200;
  rect1.height = 25;

  const rect2 = new Rectangle();
  rect2.x = 100;
  rect2.y = 100;
  rect2.width = 200;
  rect2.height = 25;

  const field1 = new FormField();
  field1.id = "Signature1";
  field1.fieldType = FormField.FieldTypeEnum.Signature;
  field1.pageNumber = 1;
  field1.bounds = rect1;
  field1.isRequired = true;

  const field2 = new FormField();
  field2.id = "Signature2";
  field2.fieldType = FormField.FieldTypeEnum.Signature;
  field2.pageNumber = 2;
  field2.bounds = rect2;
  field2.isRequired = true;

  const signer1 = new DocumentSigner();
  signer1.name = "Alex";
  signer1.emailAddress = "alex@example.com";
  signer1.signerType = DocumentSigner.SignerTypeEnum.Signer;
  signer1.formFields = [field1];
  signer1.locale = "EN";

  const signer2 = new DocumentSigner();
  signer2.name = "Sam";
  signer2.emailAddress = "sam@example.com";
  signer2.signerType = DocumentSigner.SignerTypeEnum.Signer;
  signer2.formFields = [field2];
  signer2.locale = "EN";

  const send = new SendForSign();
  send.title = "DOCUMENT_TITLE";
  send.signers = [signer1, signer2];
  send.files = [fs.createReadStream("FILE_PATH")];

  const documentCreated = await api.sendDocument(send);
}

main();
<?php
require_once "vendor/autoload.php";

$config = new BoldSign\Configuration();
$config->setApiKey('YOUR_API_KEY');

$api = new BoldSign\Api\DocumentApi($config);

$bounds1 = new BoldSign\Model\Rectangle();
$bounds1->setX(50);
$bounds1->setY(50);
$bounds1->setWidth(200);
$bounds1->setHeight(25);

$bounds2 = new BoldSign\Model\Rectangle();
$bounds2->setX(100);
$bounds2->setY(100);
$bounds2->setWidth(200);
$bounds2->setHeight(25);

$field1 = new BoldSign\Model\FormField();
$field1->setId("Signature1");
$field1->setFieldType("Signature");
$field1->setPageNumber(1);
$field1->setBounds($bounds1);
$field1->setIsRequired(true);

$field2 = new BoldSign\Model\FormField();
$field2->setId("Signature2");
$field2->setFieldType("Signature");
$field2->setPageNumber(2);
$field2->setBounds($bounds2);
$field2->setIsRequired(true);

$signer1 = new BoldSign\Model\DocumentSigner();
$signer1->setName("Alex");
$signer1->setEmailAddress("alex@example.com");
$signer1->setSignerType("Signer");
$signer1->setFormFields([$field1]);
$signer1->setLocale("EN");

$signer2 = new BoldSign\Model\DocumentSigner();
$signer2->setName("Sam");
$signer2->setEmailAddress("sam@example.com");
$signer2->setSignerType("Signer");
$signer2->setFormFields([$field2]);
$signer2->setLocale("EN");

$send = new BoldSign\Model\SendForSign();
$send->setTitle("DOCUMENT_TITLE");
$send->setSigners([$signer1, $signer2]);
$send->setFiles(["FILE_PATH"]);

$documentCreated = $api->sendDocument($send);
ApiClient client = Configuration.getDefaultApiClient();
client.setApiKey("YOUR_API_KEY");

DocumentApi api = new DocumentApi(client);

Rectangle rect1 = new Rectangle();
rect1.setX(50f);
rect1.setY(50f);
rect1.setWidth(200f);
rect1.setHeight(25f);

Rectangle rect2 = new Rectangle();
rect2.setX(100f);
rect2.setY(100f);
rect2.setWidth(200f);
rect2.setHeight(25f);

FormField field1 = new FormField();
field1.setId("Signature1");
field1.setFieldType(FormField.FieldTypeEnum.SIGNATURE);
field1.setPageNumber(1);
field1.setBounds(rect1);
field1.setIsRequired(true);

FormField field2 = new FormField();
field2.setId("Signature2");
field2.setFieldType(FormField.FieldTypeEnum.SIGNATURE);
field2.setPageNumber(2);
field2.setBounds(rect2);
field2.setIsRequired(true);

DocumentSigner signer1 = new DocumentSigner();
signer1.setName("Alex");
signer1.setEmailAddress("alex@example.com");
signer1.setSignerType(DocumentSigner.SignerTypeEnum.SIGNER);
signer1.setFormFields(Arrays.asList(field1));
signer1.setLocale(DocumentSigner.LocaleEnum.EN);

DocumentSigner signer2 = new DocumentSigner();
signer2.setName("Sam");
signer2.setEmailAddress("sam@example.com");
signer2.setSignerType(DocumentSigner.SignerTypeEnum.SIGNER);
signer2.setFormFields(Arrays.asList(field2));
signer2.setLocale(DocumentSigner.LocaleEnum.EN);

SendForSign send = new SendForSign();
send.setTitle("DOCUMENT_TITLE");
send.setSigners(Arrays.asList(signer1, signer2));
send.setFiles(Arrays.asList(new File("FILE_PATH")));

DocumentCreated documentCreated = api.sendDocument(send);

Swap the placeholders for your own values before you run a sample. That means the API key, the file path, the document title and each signer’s details.

How do you confirm the document was sent?

Listen for webhook events, because sending is asynchronous. The API returns a document ID right away, while the file may still be processing in the background.

We send a Sent event when the request goes out to the signers. A SendFailed event means processing failed, and it carries an error message. Fix the cause, then send the request again.

Our Available webhook events page lists every event. The guide on how to validate and verify webhook events shows how to check that each one came from us.

What else can you set for multiple recipients?

The same request accepts more options next to your signers and fields. The Send Document reference lists every property with an example.

  • Set EnableSigningOrder to true when signers must sign in your order, not at the same time.
  • Add people who need updates but do not sign to the CC (carbon copy) list.
  • Choose Signer, Reviewer or InPersonSigner as each recipient’s signer type.
  • Turn on automatic reminders, with the days between them and how many to send.
  • Pass a brand ID to show your logo and colors in emails and on the signing page.

When should you use bulk send instead?

Use bulk send when each person needs their own copy. Use multiple signers when everyone must sign the same shared document.

A board resolution signed by five directors is one document with five signers. A policy that 200 staff members each acknowledge is a bulk send, usually from a template and a CSV file.

You can also build multi-signer requests from a saved template. The Send Document From Template guide shows how.

What should you check before you send?

A few small mistakes cause most failed or confusing requests. Check these before you go live:

  • Give every form field a unique ID, such as Signature1 and Signature2.
  • Make sure each field’s page number exists in your file.
  • Use the right email address for each signer, since the request goes there.
  • Turn on signing order only when the order matters.

Which BoldSign API plan do you need, and what does it cost?

Live API requests need the Enterprise API plan, from $30 a month with 40 envelopes, as listed on the BoldSign pricing page in November 2026. Each extra envelope costs $0.75, and prices are in USD.

The plan also covers webhooks, bulk send and custom branding. To build and test first, use the free sandbox. It needs no credit card, and its documents carry a test watermark and are deleted after 14 days.

Want to try the web app as well? Start a 30-day BoldSign free trial.

Ready to send your first multi-signer request?

Frequently asked questions

Can I send one document to more than one signer with the BoldSign API?

Yes. Add one entry to the Signers list for each person. Everyone gets a request for the same document, and each person fills in only their own fields.

How many signers can one API request hold?

The Send Document reference says one or more signers can be listed. It does not state an upper limit, so test large lists in the sandbox first.

How do I make signers sign in a set order?

Set EnableSigningOrder to true. Signers then sign in the order you set and cannot sign at the same time. It is false by default.

Can I copy someone on the request without asking them to sign?

Yes. Add their email address to the CC (carbon copy) list. They get updates about the document but have no fields to fill in.

What signer types does the API support?

Each recipient can be a Signer, a Reviewer or an InPersonSigner. A reviewer checks the document, and an in-person signer signs with the sender present.

How do I know the document was sent?

Listen for webhook events. A Sent event means the request went out, and a SendFailed event carries an error message to fix before you send again.

What is the difference between bulk send and multiple signers?

Multiple signers all act on one shared document. Bulk send gives each person a separate copy, often built from a template and a CSV file.

Is there a free e-sign API for testing?

Yes. Our free sandbox needs no credit card. Sandbox documents carry a test watermark and are deleted after 14 days.

Gopinath Kannusamy

Gopinath is a passionate software developer with 2 years of experience at BoldSign. He is an avid writer and enjoys sharing his insights on technology and development. In his free time, he enjoys exploring new technologies and learning new things. Connect with him on LinkedIn.

More posts by Gopinath Kannusamy
Get started

Sign up for your free trial today!

Start free trial
  • 30-day free trial
  • No credit card required