Skip to content

Signing order

Multiple Recipients Signing In Parallel

Send an envelope to several signers at the same time so each one can sign whenever they like, in any order, with the routing property set to parallel.

When sending an envelope for signatures, you can control how it’s sent to recipients using the routing property in the Envelope.

There are two options: Sequential and Parallel. By default, SignatureAPI uses sequential routing.

With Parallel Routing, the envelope is sent simultaneously to all recipients. Each recipient can sign the document whenever they want, and there is no required signing order.

In this example, we will create an envelope with:

  • A single PDF document.
  • Two recipients (signers) signing in parallel, with the keys disclosing_party and receiving_party.
  • Two signature places positioned with placeholders [[disclosing_party_signature]] and [[receiving_party_signature]].

All other envelope settings use the default configuration:

  • Each recipient receives an email with a link to sign.
  • The account’s default language, timezone, and timestamp format used.

Prepare your Document

Placeholders are text markers within your PDF document indicating specific locations for items such as signatures, initials, or text inputs. Each placeholder follows the format [[place_key]], where place_key uniquely identifies the specific location within your document.

In this example, we have prepared a document containing the placeholders [[disclosing_party_signature]] and [[receiving_party_signature]]. These placeholders mark the exact positions within the document where the signatures corresponding to each key (disclosing_party_signature and receiving_party_signature) will be inserted.

Example document

Download the PDF used in this example.

The end of the NDA with two signature lines, Disclosing Party and Receiving Party, each above a blue placeholder: [[disclosing_party_signature]] and [[receiving_party_signature]]
The two placeholders in the example document
In our document, the placeholder is highlighted in blue for visibility. However, we recommend setting it to white so it remains invisible to the signer.

Create the Envelope

When creating the envelope:

  • Set routing to parallel.
  • Add your recipient objects to the recipients property of the Envelope in any order, as they’ll be sent simultaneously.
  • Add the signature place objects to the places array inside the document object:
    • key: Must match the placeholder within the document file (e.g., disclosing_party_signature).
    • type: Set as signature.
    • recipient_key: Matches recipient keys (disclosing_party and receiving_party).
HTTP
POST /v1/envelopes HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json

{
  "title": "Mutual NDA",
  "message": "Please review and sign the Mutual NDA.",
  "routing": "parallel",
  "documents": [
    {
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/dummy-nda.pdf",
      "format": "pdf",
      "places": [
        {
          "key": "disclosing_party_signature",
          "type": "signature",
          "recipient_key": "disclosing_party"
        },
        {
          "key": "receiving_party_signature",
          "type": "signature",
          "recipient_key": "receiving_party"
        }
      ]
    }
  ],
  "recipients": [
    {
      "type": "signer",
      "key": "disclosing_party",
      "name": "Jane Doe",
      "email": "jane.doe@example.com"
    },
    {
      "type": "signer",
      "key": "receiving_party",
      "name": "John Smith",
      "email": "john.smith@example.com"
    }
  ]
}

Result

If successful, SignatureAPI will send emails to both Jane Doe (“disclosing_party”) and John Smith (“receiving_party”) with links to sign the document. Each signer places their signature on their designated signature line.

The signing ceremony on the NDA signature page with a SIGN box over the Disclosing Party line and a Start button at the top
Jane Doe's ceremony: the place over the Disclosing Party line
The signing ceremony on the NDA signature page with a SIGN box over the Receiving Party line and a Start button at the top
John Smith's ceremony: the place over the Receiving Party line

Try It

Try this example in Postman (“Create an envelope with multiple recipients signing in parallel”) using your test API key to create a free, non-binding test envelope. Test envelopes don’t send emails, but you can review them in the Dashboard.

Keep Learning