Skip to content

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_email and recipient_completed_date print the buyer’s name, email and signing date without any input. See Recipient name, Recipient email and Date places.
  • Initials places. Two initials places, odometer_initials and financing_initials, belong to the buyer. Set height between 20 and 60 points. See 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.

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. Read recipient_key and envelope_metadata.deal_id to 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.

Default
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"
    }
  ]
}
{
  "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
}

Errors every call can return are in Errors and Authentication.