Industries
Send Engagement Letters With Approver Review
Have a partner approve an engagement letter before the client initials the fee clause and signs, and name the signed package after the matter.
A firm wants a partner to review every engagement letter before it reaches the client. Add the partner as an approver. The client only receives the letter after the partner approves it, then initials the fee clause and signs.
Envelope shape
- One PDF document. The client has an
initialsplace on the fee clause and asignatureplace. See Initials. - An approver and a signer. The partner is an
approverand has no places. The client is asigner. An approver can approve or reject. See Approver. - Named deliverable.
deliverable.namelabels the signed package, so you can find it in your matter system. See Standard deliverable. - Metadata and topics.
metadata.matter_idlinks the envelope to the matter. Thelegalandengagementtopics group these envelopes. Keep client names and fee details out ofmetadata.
Routing
The envelope uses sequential routing, which approvers need. The partner is first in the recipients array, so the client is notified only after the partner approves. See Send to an approver and Sequential signing.
Webhooks to listen for
recipient.completed: fires when the partner approves and again when the client signs. Userecipient_keyandenvelope_metadata.matter_idto update the matter.recipient.rejected: the partner rejected the letter. Notify the responsible lawyer so they can revise it and send a new envelope.envelope.completed: the client signed. Open the engagement in your matter system.deliverable.generated: the package namedengagement_letter_signedis ready to download and file.
Set up the endpoint as shown in Set up webhooks.
Compliance notes
This is general information, not legal advice. Professional conduct rules and the validity of electronic signatures on engagement letters vary by jurisdiction, so have your counsel or ethics advisers review your template and process. Webhook payloads include metadata, so use matter numbers and not confidential details.
POST /v1/envelopes HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
{
"title": "Engagement Letter (sample)",
"message": "Please review the engagement letter, initial the fee clause and sign.",
"routing": "sequential",
"metadata": {
"matter_id": "mat_2209"
},
"topics": [
"legal",
"engagement"
],
"deliverable": {
"type": "standard",
"name": "engagement_letter_signed"
},
"documents": [
{
"key": "engagement_letter",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "fee_clause_initials",
"page": 1,
"top": 250,
"left": 72
},
{
"place_key": "client_signature",
"page": 1,
"top": 172,
"left": 210
}
],
"places": [
{
"key": "fee_clause_initials",
"type": "initials",
"recipient_key": "client",
"height": 30
},
{
"key": "client_signature",
"type": "signature",
"recipient_key": "client"
}
]
}
],
"recipients": [
{
"type": "approver",
"key": "partner",
"name": "Alex Chen",
"email": "alex.chen@example.com"
},
{
"type": "signer",
"key": "client",
"name": "Jane Doe",
"email": "jane.doe@example.com"
}
]
}npx signatureapi envelopes create --body - <<'EOF'
{
"title": "Engagement Letter (sample)",
"message": "Please review the engagement letter, initial the fee clause and sign.",
"routing": "sequential",
"metadata": {
"matter_id": "mat_2209"
},
"topics": [
"legal",
"engagement"
],
"deliverable": {
"type": "standard",
"name": "engagement_letter_signed"
},
"documents": [
{
"key": "engagement_letter",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "fee_clause_initials",
"page": 1,
"top": 250,
"left": 72
},
{
"place_key": "client_signature",
"page": 1,
"top": 172,
"left": 210
}
],
"places": [
{
"key": "fee_clause_initials",
"type": "initials",
"recipient_key": "client",
"height": 30
},
{
"key": "client_signature",
"type": "signature",
"recipient_key": "client"
}
]
}
],
"recipients": [
{
"type": "approver",
"key": "partner",
"name": "Alex Chen",
"email": "alex.chen@example.com"
},
{
"type": "signer",
"key": "client",
"name": "Jane Doe",
"email": "jane.doe@example.com"
}
]
}
EOF{
"name": "create_envelope",
"arguments": {
"title": "Engagement Letter (sample)",
"message": "Please review the engagement letter, initial the fee clause and sign.",
"routing": "sequential",
"metadata": {
"matter_id": "mat_2209"
},
"topics": [
"legal",
"engagement"
],
"deliverable": {
"type": "standard",
"name": "engagement_letter_signed"
},
"documents": [
{
"key": "engagement_letter",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "fee_clause_initials",
"page": 1,
"top": 250,
"left": 72
},
{
"place_key": "client_signature",
"page": 1,
"top": 172,
"left": 210
}
],
"places": [
{
"key": "fee_clause_initials",
"type": "initials",
"recipient_key": "client",
"height": 30
},
{
"key": "client_signature",
"type": "signature",
"recipient_key": "client"
}
]
}
],
"recipients": [
{
"type": "approver",
"key": "partner",
"name": "Alex Chen",
"email": "alex.chen@example.com"
},
{
"type": "signer",
"key": "client",
"name": "Jane Doe",
"email": "jane.doe@example.com"
}
]
}
}{
"id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"title": "Engagement Letter (sample)",
"label": null,
"message": "Please review the engagement letter, initial the fee clause and sign.",
"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": "engagement_letter_signed",
"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": [
"engagement_letter"
]
},
"metadata": {
"matter_id": "mat_2209"
},
"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": "engagement_letter",
"title": null,
"page_count": 1,
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"page": 1,
"top": 250,
"left": 72,
"place_key": "fee_clause_initials"
},
{
"page": 1,
"top": 172,
"left": 210,
"place_key": "client_signature"
}
],
"places": [
{
"key": "fee_clause_initials",
"type": "initials",
"recipient_key": "client",
"height": 30
},
{
"key": "client_signature",
"type": "signature",
"recipient_key": "client",
"height": 60
}
]
}
],
"recipients": [
{
"id": "re_HVl3Nj7XzTzX7jN3lVH5vn",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "approver",
"key": "partner",
"email": "alex.chen@example.com",
"name": "Alex Chen",
"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": "none",
"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": [
"legal",
"engagement"
],
"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.