---
title: "Send Dealer Purchase Agreements and Test-Drive Waivers"
description: "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."
canonical: "https://signatureapi.com/docs/use-cases/automotive"
source: "https://signatureapi.com/docs/use-cases/automotive.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T17:35:55Z"
---

# 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.

_Last verified against API version 1.18.0._

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_email` and `recipient_completed_date` print the buyer's name, email and signing date without any input. See [Recipient name](https://signatureapi.com/docs/api/resources/places/recipient-name), [Recipient email](https://signatureapi.com/docs/api/resources/places/recipient-email) and [Date places](https://signatureapi.com/docs/api/resources/places/date).
- **Initials places.** Two `initials` places, `odometer_initials` and `financing_initials`, belong to the buyer. Set `height` between 20 and 60 points. See [Initials](https://signatureapi.com/docs/api/resources/places/initials).
- **Envelope completed date.** `completed_on` is an `envelope_completed_date` place. It stamps the moment every recipient has finished and needs no `recipient_key`.
- **Fixed positions and metadata.** The sample PDF has no placeholders, so `fixed_positions` place each one. `metadata.deal_id` ties the envelope to your deal. See [Use fixed positions](https://signatureapi.com/docs/api/guides/how-to/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](https://signatureapi.com/docs/api/guides/how-to/sequential-signing).

## Webhooks to listen for

- [`recipient.completed`](https://signatureapi.com/docs/api/resources/events/recipient-events): fires after the buyer and again after the representative. Read `recipient_key` and `envelope_metadata.deal_id` to move the deal to the next stage.
- [`recipient.rejected`](https://signatureapi.com/docs/api/resources/events/recipient-events): the buyer declined. This does not cancel the envelope, so notify the salesperson, then replace the recipient or cancel.
- [`envelope.completed`](https://signatureapi.com/docs/api/resources/events/envelope-events): both parties have signed. Mark the deal as signed.
- [`deliverable.generated`](https://signatureapi.com/docs/api/resources/events/deliverable-events): 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](https://signatureapi.com/docs/api/guides/how-to/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.

### Example: Default

Vehicle Purchase Agreement (sample).

```http
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"
    }
  ]
}
```

Response 201 Created:

```json
{
  "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
}
```

Response 422 Unprocessable Content:

```json
{
  "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 that any request can return (authentication, rate limits, server errors) are on the [Errors](https://signatureapi.com/docs/api/errors) and [Authentication](https://signatureapi.com/docs/api/authentication) pages.
