Cookbook
Board resolution signed in parallel
Send one resolution to several directors at once so each signs in any order, using parallel routing and one signature place per director.
Send a resolution to three directors at the same time. Each signs when ready, and the envelope completes when the last one has.
- Parallel routing. Every director is notified when the envelope starts. See parallel signing.
- Only signing recipient types. Parallel routing accepts
signer,qualified_signerandautomatic_signerrecipients. An approver or preparer needssequential. - No form fields. Text inputs, checkboxes and dropdowns are allowed only in sequential envelopes.
- Fixed positions. This sample PDF has no placeholders, so each director’s place gets a page and coordinates, side by side on the signature line. Use your own coordinates for your document: see fixed positions.
Follow progress
Each signature fires recipient.completed, and envelope.completed fires after the last. A director who declines fires recipient.rejected but does not cancel the envelope. To chase a slow director, see scheduled reminders.
Related
Three directors in parallel
POST /v1/envelopes HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
{
"title": "Board Resolution 2026-11",
"message": "Please review and sign the board resolution.",
"routing": "parallel",
"topics": [
"board"
],
"documents": [
{
"key": "resolution",
"title": "Board Resolution 2026-11",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/privacy-fixed.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "director_1",
"page": 2,
"top": 410,
"left": 73
},
{
"place_key": "director_2",
"page": 2,
"top": 410,
"left": 233
},
{
"place_key": "director_3",
"page": 2,
"top": 410,
"left": 393
}
],
"places": [
{
"key": "director_1",
"type": "signature",
"recipient_key": "jane"
},
{
"key": "director_2",
"type": "signature",
"recipient_key": "john"
},
{
"key": "director_3",
"type": "signature",
"recipient_key": "maria"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "jane",
"name": "Jane Doe",
"email": "jane.doe@example.com"
},
{
"type": "signer",
"key": "john",
"name": "John Smith",
"email": "john.smith@example.com"
},
{
"type": "signer",
"key": "maria",
"name": "Maria Garcia",
"email": "maria.garcia@example.com"
}
]
}npx signatureapi envelopes create --body - <<'EOF'
{
"title": "Board Resolution 2026-11",
"message": "Please review and sign the board resolution.",
"routing": "parallel",
"topics": [
"board"
],
"documents": [
{
"key": "resolution",
"title": "Board Resolution 2026-11",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/privacy-fixed.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "director_1",
"page": 2,
"top": 410,
"left": 73
},
{
"place_key": "director_2",
"page": 2,
"top": 410,
"left": 233
},
{
"place_key": "director_3",
"page": 2,
"top": 410,
"left": 393
}
],
"places": [
{
"key": "director_1",
"type": "signature",
"recipient_key": "jane"
},
{
"key": "director_2",
"type": "signature",
"recipient_key": "john"
},
{
"key": "director_3",
"type": "signature",
"recipient_key": "maria"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "jane",
"name": "Jane Doe",
"email": "jane.doe@example.com"
},
{
"type": "signer",
"key": "john",
"name": "John Smith",
"email": "john.smith@example.com"
},
{
"type": "signer",
"key": "maria",
"name": "Maria Garcia",
"email": "maria.garcia@example.com"
}
]
}
EOF{
"name": "create_envelope",
"arguments": {
"title": "Board Resolution 2026-11",
"message": "Please review and sign the board resolution.",
"routing": "parallel",
"topics": [
"board"
],
"documents": [
{
"key": "resolution",
"title": "Board Resolution 2026-11",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/privacy-fixed.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "director_1",
"page": 2,
"top": 410,
"left": 73
},
{
"place_key": "director_2",
"page": 2,
"top": 410,
"left": 233
},
{
"place_key": "director_3",
"page": 2,
"top": 410,
"left": 393
}
],
"places": [
{
"key": "director_1",
"type": "signature",
"recipient_key": "jane"
},
{
"key": "director_2",
"type": "signature",
"recipient_key": "john"
},
{
"key": "director_3",
"type": "signature",
"recipient_key": "maria"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "jane",
"name": "Jane Doe",
"email": "jane.doe@example.com"
},
{
"type": "signer",
"key": "john",
"name": "John Smith",
"email": "john.smith@example.com"
},
{
"type": "signer",
"key": "maria",
"name": "Maria Garcia",
"email": "maria.garcia@example.com"
}
]
}
}{
"id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"title": "Board Resolution 2026-11",
"label": null,
"message": "Please review and sign the board resolution.",
"status": "processing",
"mode": "test",
"routing": "parallel",
"language": "en",
"timezone": "UTC",
"timestamp_format": "MM/DD/YYYY HH:mm:ss",
"attestation": "none",
"branding": {
"logo": null,
"accent_color": "#2463eb",
"email": {
"from": "noreply@signatureapi.com",
"footer": null,
"logo_position": "left"
}
},
"sender": {
"name": "Acme Corp Legal",
"email": "legal@acme.example",
"organization": "Acme Corp"
},
"topics": [
"board"
],
"metadata": {},
"documents": [
{
"id": "doc_4YvlxUZN28CeonDq6rTbvk",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"key": "resolution",
"title": "Board Resolution 2026-11",
"page_count": 2,
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/privacy-fixed.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "director_1",
"page": 2,
"top": 410,
"left": 73
},
{
"place_key": "director_2",
"page": 2,
"top": 410,
"left": 233
},
{
"place_key": "director_3",
"page": 2,
"top": 410,
"left": 393
}
],
"places": [
{
"key": "director_1",
"type": "signature",
"recipient_key": "jane",
"height": 60
},
{
"key": "director_2",
"type": "signature",
"recipient_key": "john",
"height": 60
},
{
"key": "director_3",
"type": "signature",
"recipient_key": "maria",
"height": 60
}
]
}
],
"recipients": [
{
"id": "re_49r1R2jpPDz8hSpP75ZkPp",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "signer",
"key": "jane",
"name": "Jane Doe",
"email": "jane.doe@example.com",
"status": "pending",
"ceremony": {
"authentication": [
{
"type": "email_link",
"subject_override": null,
"message_override": null
}
],
"redirect_url": null,
"redirect_delay": 3,
"embeddable_in": [],
"url_variant": "standard",
"url": null
},
"delivery_type": "email",
"ceremony_creation": "automatic",
"signature_options": [
"typed",
"drawn"
],
"completed_at": null,
"status_updated_at": "2026-11-02T14:03:11.000Z"
},
{
"id": "re_4VP9v4uPj6jwZzQ14CG2O8",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "signer",
"key": "john",
"name": "John Smith",
"email": "john.smith@example.com",
"status": "pending",
"ceremony": {
"authentication": [
{
"type": "email_link",
"subject_override": null,
"message_override": null
}
],
"redirect_url": null,
"redirect_delay": 3,
"embeddable_in": [],
"url_variant": "standard",
"url": null
},
"delivery_type": "email",
"ceremony_creation": "automatic",
"signature_options": [
"typed",
"drawn"
],
"completed_at": null,
"status_updated_at": "2026-11-02T14:03:11.000Z"
},
{
"id": "re_2f0wBwlt2te0kjU5QeL3Nl",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "signer",
"key": "maria",
"name": "Maria Garcia",
"email": "maria.garcia@example.com",
"status": "pending",
"ceremony": {
"authentication": [
{
"type": "email_link",
"subject_override": null,
"message_override": null
}
],
"redirect_url": null,
"redirect_delay": 3,
"embeddable_in": [],
"url_variant": "standard",
"url": null
},
"delivery_type": "email",
"ceremony_creation": "automatic",
"signature_options": [
"typed",
"drawn"
],
"completed_at": null,
"status_updated_at": "2026-11-02T14:03:11.000Z"
}
],
"deliverable": {
"id": "del_6FF89lKNyTNamOJCJd1tLL",
"name": null,
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "standard",
"status": "pending",
"url": null,
"language": "en",
"timezone": "UTC",
"timestamp_format": "MM/DD/YYYY HH:mm:ss",
"included_documents": [
"resolution"
],
"password": null,
"created_at": "2026-11-02T14:03:11.000Z",
"generated_at": null
},
"captures": {},
"snapshot_url": null,
"created_at": "2026-11-02T14:03:11.000Z",
"completed_at": null
}{
"type": "https://signatureapi.com/docs/v1/errors/validation-error",
"title": "Validation Error",
"status": 422,
"detail": "The request body contains validation errors.",
"errors": [
"recipients[0].email must be a valid email address"
]
}Errors every call can return are in Errors and Authentication.