Multiple signers

A document can be signed and approved by several people — and you can determine the order in which it reaches each of them.

How to add more signers

Each person is one item in the people array in the JSON instructions:

{
    "people": [
        {
            "is_proposer": true,
            "email": "vas@email.cz",
            "contract_role": "approve"
        },
        {
            "is_proposer": false,
            "email": "prvni@protistrana.cz",
            "contract_role": "sign",
            "first_name": "Jan",
            "last_name": "Novák",
            "person_type": "legal",
            "positions": [ { "x": 20, "y": 80, "page": 0 } ]
        },
        {
            "is_proposer": false,
            "email": "druhy@protistrana.cz",
            "contract_role": "sign",
            "first_name": "Petr",
            "last_name": "Svoboda",
            "person_type": "legal",
            "positions": [ { "x": 70, "y": 80, "page": 0 } ]
        }
    ],
    "file": "uploaded_file_key"
}

Key fields:

• is_proposer — at least one person must be the proposer (author of the document); there can also be more than one proposer. The proposer must have a Signi account and be in the workspace.
• contract_role — sign signs, approve only approves. You can find a list of all signing roles in the article Signing roles.
• first_name, last_name, person_type — these details are required for people without a Signi account.
• positions — the position in the document where you want to place the signature, see Where to place signatures in the document.

What is returned:

{
    "contract_id": 1234567,
    "state": "pending",
    "notifications": [
        { "email": "vas@email.cz",
          "links": { "contract": "https://app.signi.com/dashboard/workspace/…/documents/1234567" } },
        { "email": "prvni@protistrana.cz",
          "links": { "contract": "https://app.signi.com/signing/…/received" } },
        { "email": "druhy@protistrana.cz",
          "links": { "contract": "https://app.signi.com/signing/…/received" } }
    ]
}

Each person has their own link in notifications — the proposer to the workspace, the signers directly to the signing page.

Signing order

Default behavior: the invitation goes to everyone at once. Sequential signing is enabled in settings with the signing_order parameter — the order is then determined by the order of people in the JSON. Details in the article Signer order.

The party_order field is not related to the signing order — it is the number of the contracting party and is used with documents from a template.

Where to go next

• Where to place signatures in the document
• Quickstart — your first document to sign via API