Industries
Send Proposals and Statements of Work
Send a statement of work and a mutual NDA in one envelope, signed by the agency lead and then the client, and name the signed package for your project system.
An agency often needs two documents signed before a project starts: the statement of work (SOW) and a mutual NDA. Sending them as one envelope means one invitation per signer and one signed package at the end.
Envelope shape
- Two PDF documents. The documents have the keys
sowandnda. Each has its ownplacesandfixed_positions, and place keys are unique across the envelope. See Use fixed positions. - Two signers, one place each per document. The agency lead and the client each get a
signatureplace on both documents. - Named deliverable.
deliverable.included_documentslists the document keys that go into the signed package.deliverable.namenames it. See Standard deliverable. - Metadata and topics.
metadata.project_codeandmetadata.sow_versionlink the envelope to your project system. Theagencyandsowtopics group these envelopes. See Organize with topics and metadata.
The request has no sender block, so recipients see the account’s default sender. To show another name and email, add a sender block. Its email must already be an authorized sender on your account, or the API returns 422.
Routing
The envelope uses sequential routing. The agency lead is first in the recipients array and signs before the client is notified. That way the client always signs a document your side has already signed. See Sequential signing.
Webhooks to listen for
recipient.completed: fires when the agency lead signs and again when the client signs. Userecipient_keyto tell which.envelope.completed: both signers have finished. Mark the project as ready to start.deliverable.generated: the package namedproject_kickoffis ready to download and file with the project.
Set up the endpoint as shown in Set up webhooks.
Compliance notes
This is general information, not legal advice. Whether an electronic signature is valid for a contract or NDA depends on your jurisdiction and the type of agreement, so have counsel review your documents and process. Keep pricing and other confidential terms out of metadata, which appears in webhook payloads.
POST /v1/envelopes HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
{
"title": "Statement of Work and Mutual NDA (sample)",
"message": "Please sign both documents to start the project.",
"routing": "sequential",
"metadata": {
"project_code": "prj_301",
"sow_version": "v3"
},
"topics": [
"agency",
"sow"
],
"deliverable": {
"type": "standard",
"name": "project_kickoff",
"included_documents": [
"sow",
"nda"
]
},
"documents": [
{
"key": "sow",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "client_signs_sow",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "agency_signs_sow",
"page": 1,
"top": 186,
"left": 220
}
],
"places": [
{
"key": "client_signs_sow",
"type": "signature",
"recipient_key": "client"
},
{
"key": "agency_signs_sow",
"type": "signature",
"recipient_key": "agency"
}
]
},
{
"key": "nda",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "client_signs_nda",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "agency_signs_nda",
"page": 1,
"top": 186,
"left": 220
}
],
"places": [
{
"key": "client_signs_nda",
"type": "signature",
"recipient_key": "client"
},
{
"key": "agency_signs_nda",
"type": "signature",
"recipient_key": "agency"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "agency",
"name": "John Smith",
"email": "john.smith@example.com"
},
{
"type": "signer",
"key": "client",
"name": "Jane Doe",
"email": "jane.doe@example.com"
}
]
}npx signatureapi envelopes create --body - <<'EOF'
{
"title": "Statement of Work and Mutual NDA (sample)",
"message": "Please sign both documents to start the project.",
"routing": "sequential",
"metadata": {
"project_code": "prj_301",
"sow_version": "v3"
},
"topics": [
"agency",
"sow"
],
"deliverable": {
"type": "standard",
"name": "project_kickoff",
"included_documents": [
"sow",
"nda"
]
},
"documents": [
{
"key": "sow",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "client_signs_sow",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "agency_signs_sow",
"page": 1,
"top": 186,
"left": 220
}
],
"places": [
{
"key": "client_signs_sow",
"type": "signature",
"recipient_key": "client"
},
{
"key": "agency_signs_sow",
"type": "signature",
"recipient_key": "agency"
}
]
},
{
"key": "nda",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "client_signs_nda",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "agency_signs_nda",
"page": 1,
"top": 186,
"left": 220
}
],
"places": [
{
"key": "client_signs_nda",
"type": "signature",
"recipient_key": "client"
},
{
"key": "agency_signs_nda",
"type": "signature",
"recipient_key": "agency"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "agency",
"name": "John Smith",
"email": "john.smith@example.com"
},
{
"type": "signer",
"key": "client",
"name": "Jane Doe",
"email": "jane.doe@example.com"
}
]
}
EOF{
"name": "create_envelope",
"arguments": {
"title": "Statement of Work and Mutual NDA (sample)",
"message": "Please sign both documents to start the project.",
"routing": "sequential",
"metadata": {
"project_code": "prj_301",
"sow_version": "v3"
},
"topics": [
"agency",
"sow"
],
"deliverable": {
"type": "standard",
"name": "project_kickoff",
"included_documents": [
"sow",
"nda"
]
},
"documents": [
{
"key": "sow",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "client_signs_sow",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "agency_signs_sow",
"page": 1,
"top": 186,
"left": 220
}
],
"places": [
{
"key": "client_signs_sow",
"type": "signature",
"recipient_key": "client"
},
{
"key": "agency_signs_sow",
"type": "signature",
"recipient_key": "agency"
}
]
},
{
"key": "nda",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "client_signs_nda",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "agency_signs_nda",
"page": 1,
"top": 186,
"left": 220
}
],
"places": [
{
"key": "client_signs_nda",
"type": "signature",
"recipient_key": "client"
},
{
"key": "agency_signs_nda",
"type": "signature",
"recipient_key": "agency"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "agency",
"name": "John Smith",
"email": "john.smith@example.com"
},
{
"type": "signer",
"key": "client",
"name": "Jane Doe",
"email": "jane.doe@example.com"
}
]
}
}{
"id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"title": "Statement of Work and Mutual NDA (sample)",
"label": null,
"message": "Please sign both documents to start the project.",
"status": "processing",
"attestation": "none",
"language": "en",
"mode": "test",
"routing": "sequential",
"timezone": "UTC",
"timestamp_format": "MM/DD/YYYY HH:mm:ss",
"snapshot_url": null,
"branding": {
"logo": null,
"accent_color": "#2463EB",
"email": {
"footer": null,
"logo_position": "left",
"from": "noreply@signatureapi.com"
}
},
"deliverable": {
"id": "del_HVl3Nj7XzTzX7jN3lVH5vn",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"name": "project_kickoff",
"status": "pending",
"type": "standard",
"url": null,
"password": null,
"created_at": "2026-11-02T14:03:11.000Z",
"generated_at": null,
"timezone": "UTC",
"language": "en",
"timestamp_format": "MM/DD/YYYY HH:mm:ss",
"included_documents": [
"sow",
"nda"
]
},
"metadata": {
"project_code": "prj_301",
"sow_version": "v3"
},
"sender": {
"name": "Acme Corp Legal",
"email": "legal@acme.example",
"organization": "Acme Corp"
},
"captures": {},
"documents": [
{
"id": "doc_HVl3Nj7XzTzX7jN3lVH5vn",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"key": "sow",
"title": null,
"page_count": 1,
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"page": 1,
"top": 172,
"left": 210,
"place_key": "client_signs_sow"
},
{
"page": 1,
"top": 186,
"left": 220,
"place_key": "agency_signs_sow"
}
],
"places": [
{
"key": "client_signs_sow",
"type": "signature",
"recipient_key": "client",
"height": 60
},
{
"key": "agency_signs_sow",
"type": "signature",
"recipient_key": "agency",
"height": 60
}
]
},
{
"id": "doc_OcsAUqEe6a6eEqUAscOC2u",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"key": "nda",
"title": null,
"page_count": 1,
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"page": 1,
"top": 172,
"left": 210,
"place_key": "client_signs_nda"
},
{
"page": 1,
"top": 186,
"left": 220,
"place_key": "agency_signs_nda"
}
],
"places": [
{
"key": "client_signs_nda",
"type": "signature",
"recipient_key": "client",
"height": 60
},
{
"key": "agency_signs_nda",
"type": "signature",
"recipient_key": "agency",
"height": 60
}
]
}
],
"recipients": [
{
"id": "re_HVl3Nj7XzTzX7jN3lVH5vn",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "signer",
"key": "agency",
"email": "john.smith@example.com",
"name": "John Smith",
"ceremony": {
"authentication": [
{
"type": "email_link",
"subject_override": null,
"message_override": null
}
],
"embeddable_in": [],
"redirect_url": null,
"redirect_delay": 3,
"url": null,
"url_variant": "standard"
},
"ceremony_creation": "automatic",
"delivery_type": "email",
"signature_options": [
"typed",
"drawn"
],
"status": "pending",
"status_updated_at": "2026-11-02T14:03:11.000Z",
"completed_at": null
},
{
"id": "re_OcsAUqEe6a6eEqUAscOC2u",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "signer",
"key": "client",
"email": "jane.doe@example.com",
"name": "Jane Doe",
"ceremony": {
"authentication": [
{
"type": "email_link",
"subject_override": null,
"message_override": null
}
],
"embeddable_in": [],
"redirect_url": null,
"redirect_delay": 3,
"url": null,
"url_variant": "standard"
},
"ceremony_creation": "automatic",
"delivery_type": "email",
"signature_options": [
"typed",
"drawn"
],
"status": "awaiting",
"status_updated_at": "2026-11-02T14:03:11.000Z",
"completed_at": null
}
],
"topics": [
"agency",
"sow"
],
"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.