Default behavior: the signing invitation goes out to everyone at once. If you want people to sign sequentially, set this in settings using the signing_order parameter.
Options
| Value | Behavior |
|---|---|
all_at_once |
Everyone receives the invitation immediately (default). |
proposers_before_counterparties |
Proposers sign/approve first, then the counterparties. |
one_at_a_time |
One after another — the next person gets the invitation only after the previous one has signed. |
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 — notice the difference from the default behavior: notifications contains only the person whose turn it currently is. The next people receive the invitation (and link) only when their turn comes:
{
"contract_id": 1234567,
"state": "pending",
"notifications": [
{ "email": "vas@email.cz",
"links": { "contract": "https://app.signi.com/dashboard/workspace/…/documents/1234567" } }
]
}
Where to go next
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article