Industries
Send Residential Leases and Renewals
Send a lease to two tenants and a landlord representative at the same time, with signatures and per-tenant initials, and tag new leases and renewals.
A lease often has several parties who do not need to sign in a set order. Send the envelope to everyone at once with parallel routing, so a slow tenant does not hold up the landlord, and collect initials on pages such as the pet policy.
Envelope shape
- Three signers. Two tenants and the landlord representative are
signerrecipients, each with asignatureplace. - Initials per tenant. Each tenant also has an
initialsplace. See Initials places. - Places by fixed position. The sample PDF has no
[[placeholders]], so every place is anchored withfixed_positions. See Use fixed positions. - Metadata and topics.
metadata.lease_idandmetadata.unitidentify the lease.topicssuch asnew_leasesand a renewal topic let you filter by lease type. See Topics.
Routing
The envelope uses parallel routing. Every recipient is notified at once and can sign in any order. Parallel routing accepts only signing recipient types, so approvers and preparers need sequential routing. See Parallel signing.
Webhooks to listen for
recipient.completed: fires once per party. Readrecipient_keyandenvelope_metadata.lease_idto show which parties are still outstanding.recipient.rejected: a party declined. Alert the property manager, who can replace the recipient or cancel the envelope.envelope.completed: every party has signed. Mark the lease as executed.deliverable.generated: download the signed lease and store it with the tenancy record.
Set up the endpoint as shown in Set up webhooks.
Compliance notes
This is general information, not legal advice. Whether a residential lease or a renewal can be signed electronically, and what disclosures it must carry, depends on local law. Have counsel review your lease template and process.
POST /v1/envelopes HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
{
"title": "Residential Lease (sample)",
"message": "Please review and sign the lease. Everyone can sign in any order.",
"routing": "parallel",
"metadata": {
"lease_id": "lease_3310",
"unit": "unit_4b"
},
"topics": [
"leasing",
"new_leases"
],
"documents": [
{
"key": "lease",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "tenant_one_signature",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "tenant_two_signature",
"page": 1,
"top": 214,
"left": 210
},
{
"place_key": "landlord_signature",
"page": 1,
"top": 186,
"left": 220
},
{
"place_key": "tenant_one_initials",
"page": 1,
"top": 250,
"left": 72
},
{
"place_key": "tenant_two_initials",
"page": 1,
"top": 250,
"left": 140
}
],
"places": [
{
"key": "tenant_one_signature",
"type": "signature",
"recipient_key": "tenant_one"
},
{
"key": "tenant_two_signature",
"type": "signature",
"recipient_key": "tenant_two"
},
{
"key": "landlord_signature",
"type": "signature",
"recipient_key": "landlord"
},
{
"key": "tenant_one_initials",
"type": "initials",
"recipient_key": "tenant_one",
"height": 30
},
{
"key": "tenant_two_initials",
"type": "initials",
"recipient_key": "tenant_two",
"height": 30
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "tenant_one",
"name": "Jane Doe",
"email": "jane.doe@example.com"
},
{
"type": "signer",
"key": "tenant_two",
"name": "John Smith",
"email": "john.smith@example.com"
},
{
"type": "signer",
"key": "landlord",
"name": "Maria Garcia",
"email": "maria.garcia@example.com"
}
]
}npx signatureapi envelopes create --body - <<'EOF'
{
"title": "Residential Lease (sample)",
"message": "Please review and sign the lease. Everyone can sign in any order.",
"routing": "parallel",
"metadata": {
"lease_id": "lease_3310",
"unit": "unit_4b"
},
"topics": [
"leasing",
"new_leases"
],
"documents": [
{
"key": "lease",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "tenant_one_signature",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "tenant_two_signature",
"page": 1,
"top": 214,
"left": 210
},
{
"place_key": "landlord_signature",
"page": 1,
"top": 186,
"left": 220
},
{
"place_key": "tenant_one_initials",
"page": 1,
"top": 250,
"left": 72
},
{
"place_key": "tenant_two_initials",
"page": 1,
"top": 250,
"left": 140
}
],
"places": [
{
"key": "tenant_one_signature",
"type": "signature",
"recipient_key": "tenant_one"
},
{
"key": "tenant_two_signature",
"type": "signature",
"recipient_key": "tenant_two"
},
{
"key": "landlord_signature",
"type": "signature",
"recipient_key": "landlord"
},
{
"key": "tenant_one_initials",
"type": "initials",
"recipient_key": "tenant_one",
"height": 30
},
{
"key": "tenant_two_initials",
"type": "initials",
"recipient_key": "tenant_two",
"height": 30
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "tenant_one",
"name": "Jane Doe",
"email": "jane.doe@example.com"
},
{
"type": "signer",
"key": "tenant_two",
"name": "John Smith",
"email": "john.smith@example.com"
},
{
"type": "signer",
"key": "landlord",
"name": "Maria Garcia",
"email": "maria.garcia@example.com"
}
]
}
EOF{
"name": "create_envelope",
"arguments": {
"title": "Residential Lease (sample)",
"message": "Please review and sign the lease. Everyone can sign in any order.",
"routing": "parallel",
"metadata": {
"lease_id": "lease_3310",
"unit": "unit_4b"
},
"topics": [
"leasing",
"new_leases"
],
"documents": [
{
"key": "lease",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "tenant_one_signature",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "tenant_two_signature",
"page": 1,
"top": 214,
"left": 210
},
{
"place_key": "landlord_signature",
"page": 1,
"top": 186,
"left": 220
},
{
"place_key": "tenant_one_initials",
"page": 1,
"top": 250,
"left": 72
},
{
"place_key": "tenant_two_initials",
"page": 1,
"top": 250,
"left": 140
}
],
"places": [
{
"key": "tenant_one_signature",
"type": "signature",
"recipient_key": "tenant_one"
},
{
"key": "tenant_two_signature",
"type": "signature",
"recipient_key": "tenant_two"
},
{
"key": "landlord_signature",
"type": "signature",
"recipient_key": "landlord"
},
{
"key": "tenant_one_initials",
"type": "initials",
"recipient_key": "tenant_one",
"height": 30
},
{
"key": "tenant_two_initials",
"type": "initials",
"recipient_key": "tenant_two",
"height": 30
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "tenant_one",
"name": "Jane Doe",
"email": "jane.doe@example.com"
},
{
"type": "signer",
"key": "tenant_two",
"name": "John Smith",
"email": "john.smith@example.com"
},
{
"type": "signer",
"key": "landlord",
"name": "Maria Garcia",
"email": "maria.garcia@example.com"
}
]
}
}{
"id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"title": "Residential Lease (sample)",
"label": null,
"message": "Please review and sign the lease. Everyone can sign in any order.",
"status": "processing",
"attestation": "none",
"language": "en",
"mode": "test",
"routing": "parallel",
"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": null,
"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": [
"lease"
]
},
"metadata": {
"lease_id": "lease_3310",
"unit": "unit_4b"
},
"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": "lease",
"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": "tenant_one_signature"
},
{
"page": 1,
"top": 214,
"left": 210,
"place_key": "tenant_two_signature"
},
{
"page": 1,
"top": 186,
"left": 220,
"place_key": "landlord_signature"
},
{
"page": 1,
"top": 250,
"left": 72,
"place_key": "tenant_one_initials"
},
{
"page": 1,
"top": 250,
"left": 140,
"place_key": "tenant_two_initials"
}
],
"places": [
{
"key": "tenant_one_signature",
"type": "signature",
"recipient_key": "tenant_one",
"height": 60
},
{
"key": "tenant_two_signature",
"type": "signature",
"recipient_key": "tenant_two",
"height": 60
},
{
"key": "landlord_signature",
"type": "signature",
"recipient_key": "landlord",
"height": 60
},
{
"key": "tenant_one_initials",
"type": "initials",
"recipient_key": "tenant_one",
"height": 30
},
{
"key": "tenant_two_initials",
"type": "initials",
"recipient_key": "tenant_two",
"height": 30
}
]
}
],
"recipients": [
{
"id": "re_HVl3Nj7XzTzX7jN3lVH5vn",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "signer",
"key": "tenant_one",
"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": "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": "tenant_two",
"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_VjzHbxLlDhDlLxbHzjVJ91",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "signer",
"key": "landlord",
"email": "maria.garcia@example.com",
"name": "Maria Garcia",
"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
}
],
"topics": [
"leasing",
"new_leases"
],
"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.