Leads

Request a test-drive time from the listing dealership

post/v1/leads/test-drives

Request

  • Base URL: https://api.carhandshake.com
  • URL: https://api.carhandshake.com/v1/leads/test-drives
  • Auth: none required

Headers

Idempotency-Keystring required

A unique key (8–200 characters) used to safely retry this submission.

X-Captcha-Tokenstring

Required only when optional browser verification is configured; connector and direct API clients do not send it.

Request body

listing_idstring uuid required
messagestring
requested_atstring date-time required

Requested dealer-local appointment instant, at least 15 minutes ahead.

duration_minutesinteger

Example request

{
  "customer": {
    "phone": "+13035550100"
  }
}

Response

Request accepted for consented delivery

lead_idstring uuid required
status'received' | 'duplicate' required
messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.