Industries
Send Dealer Purchase Agreements and Test-Drive Waivers
Send a vehicle purchase agreement where the buyer only initials and signs, while their name, email and the dates fill in automatically for the dealership.
A vehicle deal has many small places: initials on each disclosure, the buyer name under the signature, the date beside it. Typing those by hand is where mistakes happen. This envelope fills the repeatable values automatically, so the buyer only initials and signs. A test-drive waiver follows the same pattern with one signer and fewer places.
Envelope shape
- Auto-filled places.
recipient_name,recipient_emailandrecipient_completed_dateprint the buyer’s name, email and signing date without any input. See Recipient name, Recipient email and Date places. - Initials places. Two
initialsplaces,odometer_initialsandfinancing_initials, belong to the buyer. Setheightbetween 20 and 60 points. See Initials. - Envelope completed date.
completed_onis anenvelope_completed_dateplace. It stamps the moment every recipient has finished and needs norecipient_key. - Fixed positions and metadata. The sample PDF has no placeholders, so
fixed_positionsplace each one.metadata.deal_idties the envelope to your deal. See Use fixed positions.
Routing
The envelope uses sequential routing. The buyer initials and signs first, then the dealership representative signs. Both are signer recipients. See Sequential signing.
Webhooks to listen for
recipient.completed: fires after the buyer and again after the representative. Readrecipient_keyandenvelope_metadata.deal_idto move the deal to the next stage.recipient.rejected: the buyer declined. This does not cancel the envelope, so notify the salesperson, then replace the recipient or cancel.envelope.completed: both parties have signed. Mark the deal as signed.deliverable.generated: the signed agreement and audit log are ready to download and file with the deal.
Set up the endpoint as shown in Set up webhooks.
Compliance notes
This is general information, not legal advice. Disclosure, document and signature requirements for vehicle sales and financing vary by jurisdiction and lender, so have counsel review your agreement and process. Keep personal data out of metadata, which appears in webhook payloads. The buyer’s name and email appear on the document through the auto-filled places instead.
POST /v1/envelopes HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
{
"title": "Vehicle Purchase Agreement (sample)",
"message": "Please review the agreement, initial the disclosures and sign.",
"routing": "sequential",
"metadata": {
"deal_id": "deal_5150"
},
"topics": [
"automotive",
"purchase"
],
"documents": [
{
"key": "purchase_agreement",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "odometer_initials",
"page": 1,
"top": 250,
"left": 72
},
{
"place_key": "financing_initials",
"page": 1,
"top": 250,
"left": 140
},
{
"place_key": "buyer_signature",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "buyer_name",
"page": 1,
"top": 200,
"left": 210
},
{
"place_key": "buyer_email",
"page": 1,
"top": 214,
"left": 210
},
{
"place_key": "buyer_signed_on",
"page": 1,
"top": 172,
"left": 420
},
{
"place_key": "dealer_signature",
"page": 1,
"top": 186,
"left": 220
},
{
"place_key": "completed_on",
"page": 1,
"top": 186,
"left": 430
}
],
"places": [
{
"key": "odometer_initials",
"type": "initials",
"recipient_key": "buyer",
"height": 30
},
{
"key": "financing_initials",
"type": "initials",
"recipient_key": "buyer",
"height": 30
},
{
"key": "buyer_signature",
"type": "signature",
"recipient_key": "buyer"
},
{
"key": "buyer_name",
"type": "recipient_name",
"recipient_key": "buyer"
},
{
"key": "buyer_email",
"type": "recipient_email",
"recipient_key": "buyer"
},
{
"key": "buyer_signed_on",
"type": "recipient_completed_date",
"recipient_key": "buyer",
"date_format": "MMM D, YYYY"
},
{
"key": "dealer_signature",
"type": "signature",
"recipient_key": "dealer"
},
{
"key": "completed_on",
"type": "envelope_completed_date",
"date_format": "MMM D, YYYY"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "buyer",
"name": "Jane Doe",
"email": "jane.doe@example.com"
},
{
"type": "signer",
"key": "dealer",
"name": "John Smith",
"email": "john.smith@example.com"
}
]
}npx signatureapi envelopes create --body - <<'EOF'
{
"title": "Vehicle Purchase Agreement (sample)",
"message": "Please review the agreement, initial the disclosures and sign.",
"routing": "sequential",
"metadata": {
"deal_id": "deal_5150"
},
"topics": [
"automotive",
"purchase"
],
"documents": [
{
"key": "purchase_agreement",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "odometer_initials",
"page": 1,
"top": 250,
"left": 72
},
{
"place_key": "financing_initials",
"page": 1,
"top": 250,
"left": 140
},
{
"place_key": "buyer_signature",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "buyer_name",
"page": 1,
"top": 200,
"left": 210
},
{
"place_key": "buyer_email",
"page": 1,
"top": 214,
"left": 210
},
{
"place_key": "buyer_signed_on",
"page": 1,
"top": 172,
"left": 420
},
{
"place_key": "dealer_signature",
"page": 1,
"top": 186,
"left": 220
},
{
"place_key": "completed_on",
"page": 1,
"top": 186,
"left": 430
}
],
"places": [
{
"key": "odometer_initials",
"type": "initials",
"recipient_key": "buyer",
"height": 30
},
{
"key": "financing_initials",
"type": "initials",
"recipient_key": "buyer",
"height": 30
},
{
"key": "buyer_signature",
"type": "signature",
"recipient_key": "buyer"
},
{
"key": "buyer_name",
"type": "recipient_name",
"recipient_key": "buyer"
},
{
"key": "buyer_email",
"type": "recipient_email",
"recipient_key": "buyer"
},
{
"key": "buyer_signed_on",
"type": "recipient_completed_date",
"recipient_key": "buyer",
"date_format": "MMM D, YYYY"
},
{
"key": "dealer_signature",
"type": "signature",
"recipient_key": "dealer"
},
{
"key": "completed_on",
"type": "envelope_completed_date",
"date_format": "MMM D, YYYY"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "buyer",
"name": "Jane Doe",
"email": "jane.doe@example.com"
},
{
"type": "signer",
"key": "dealer",
"name": "John Smith",
"email": "john.smith@example.com"
}
]
}
EOF{
"name": "create_envelope",
"arguments": {
"title": "Vehicle Purchase Agreement (sample)",
"message": "Please review the agreement, initial the disclosures and sign.",
"routing": "sequential",
"metadata": {
"deal_id": "deal_5150"
},
"topics": [
"automotive",
"purchase"
],
"documents": [
{
"key": "purchase_agreement",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "odometer_initials",
"page": 1,
"top": 250,
"left": 72
},
{
"place_key": "financing_initials",
"page": 1,
"top": 250,
"left": 140
},
{
"place_key": "buyer_signature",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "buyer_name",
"page": 1,
"top": 200,
"left": 210
},
{
"place_key": "buyer_email",
"page": 1,
"top": 214,
"left": 210
},
{
"place_key": "buyer_signed_on",
"page": 1,
"top": 172,
"left": 420
},
{
"place_key": "dealer_signature",
"page": 1,
"top": 186,
"left": 220
},
{
"place_key": "completed_on",
"page": 1,
"top": 186,
"left": 430
}
],
"places": [
{
"key": "odometer_initials",
"type": "initials",
"recipient_key": "buyer",
"height": 30
},
{
"key": "financing_initials",
"type": "initials",
"recipient_key": "buyer",
"height": 30
},
{
"key": "buyer_signature",
"type": "signature",
"recipient_key": "buyer"
},
{
"key": "buyer_name",
"type": "recipient_name",
"recipient_key": "buyer"
},
{
"key": "buyer_email",
"type": "recipient_email",
"recipient_key": "buyer"
},
{
"key": "buyer_signed_on",
"type": "recipient_completed_date",
"recipient_key": "buyer",
"date_format": "MMM D, YYYY"
},
{
"key": "dealer_signature",
"type": "signature",
"recipient_key": "dealer"
},
{
"key": "completed_on",
"type": "envelope_completed_date",
"date_format": "MMM D, YYYY"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "buyer",
"name": "Jane Doe",
"email": "jane.doe@example.com"
},
{
"type": "signer",
"key": "dealer",
"name": "John Smith",
"email": "john.smith@example.com"
}
]
}
}{
"id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"title": "Vehicle Purchase Agreement (sample)",
"label": null,
"message": "Please review the agreement, initial the disclosures 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": 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": [
"purchase_agreement"
]
},
"metadata": {
"deal_id": "deal_5150"
},
"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": "purchase_agreement",
"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": "odometer_initials"
},
{
"page": 1,
"top": 250,
"left": 140,
"place_key": "financing_initials"
},
{
"page": 1,
"top": 172,
"left": 210,
"place_key": "buyer_signature"
},
{
"page": 1,
"top": 200,
"left": 210,
"place_key": "buyer_name"
},
{
"page": 1,
"top": 214,
"left": 210,
"place_key": "buyer_email"
},
{
"page": 1,
"top": 172,
"left": 420,
"place_key": "buyer_signed_on"
},
{
"page": 1,
"top": 186,
"left": 220,
"place_key": "dealer_signature"
},
{
"page": 1,
"top": 186,
"left": 430,
"place_key": "completed_on"
}
],
"places": [
{
"key": "odometer_initials",
"type": "initials",
"recipient_key": "buyer",
"height": 30
},
{
"key": "financing_initials",
"type": "initials",
"recipient_key": "buyer",
"height": 30
},
{
"key": "buyer_signature",
"type": "signature",
"recipient_key": "buyer",
"height": 60
},
{
"key": "buyer_name",
"type": "recipient_name",
"recipient_key": "buyer",
"font_size": 12
},
{
"key": "buyer_email",
"type": "recipient_email",
"recipient_key": "buyer",
"font_size": 12
},
{
"key": "buyer_signed_on",
"type": "recipient_completed_date",
"recipient_key": "buyer",
"date_format": "MMM D, YYYY",
"font_size": 12
},
{
"key": "dealer_signature",
"type": "signature",
"recipient_key": "dealer",
"height": 60
},
{
"key": "completed_on",
"type": "envelope_completed_date",
"date_format": "MMM D, YYYY",
"font_size": 12
}
]
}
],
"recipients": [
{
"id": "re_HVl3Nj7XzTzX7jN3lVH5vn",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "signer",
"key": "buyer",
"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": "dealer",
"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": "awaiting",
"status_updated_at": "2026-11-02T14:03:11.000Z",
"completed_at": null
}
],
"topics": [
"automotive",
"purchase"
],
"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.