Signing order (API)

Default behavior: the signing request goes out to everyone at once. If you want sequential signing, set it in settings using the signing_order parameter.

Options

With one_at_a_time, the order is determined by the order of people in the people array in the JSON instructions.

Example

The proposer approves, then Jan signs, followed by Petr:

{
    "people": [
        {
            "is_proposer": true,
            "email": "vas@email.cz",
            "contract_role": "approve"
        },
        {
            "is_proposer": false,
            "email": "jan@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": "petr@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",
    "settings": {
        "signing_order": "one_at_a_time"
    }
}

What you get back — note the difference from the default behavior: notifications contains only the person whose turn it currently is. The other people get the request (and the link) only when it's their turn:

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

Where to go next

• Multiple signers
• Signing roles — who does what with the document