VehicleWaitlistRequest

Request body for POST /vehicle_waitlist. Device identification fields are mutually constrained: supply exactly one of (vehicle_model_id) or (both vehicle_make_name and vehicle_model_name). Any other combination returns 400. Country is not part of the request body — see endpoint description for how it is derived.

emailstring, (email)required

Email address to notify when the user's hardware becomes supported.

Example:"user@example.com"

program_idstring or nullprog[A-Z\d]{26}

Optional ProgramConfig uid. Captured where known (web signup, whitelabel microsite) so later notification logic can scope by program.

Example:"prog01HRS4TSK26BPBV7127DH7E0HA"

vehicle_model_idstring or nullvmod[A-Z\d]{26}

Uid of a CarModel. Used when the user picked from the vehicle picker. Mutually exclusive with vehicle_make_name / vehicle_model_name.

Example:"vmod01HRS4TSK26BPBV7127DH7E0HA"

vehicle_make_namestring

Free-text make name from manual entry. Must be supplied together with vehicle_model_name. Mutually exclusive with vehicle_model_id.

Example:"Tesla"

vehicle_model_namestring

Free-text model name from manual entry. Must be supplied together with vehicle_make_name. Mutually exclusive with vehicle_model_id.

Example:"Model 3"

{
  "email": "user@example.com",
  "program_id": "prog01HRS4TSK26BPBV7127DH7E0HA",
  "vehicle_model_id": "vmod01HRS4TSK26BPBV7127DH7E0HA",
  "vehicle_make_name": "Tesla",
  "vehicle_model_name": "Model 3"
}