Leads Flow
The Leads Flow allows partners to submit lead information without requiring immediate plan results. This is ideal for lead generation campaigns where follow-up happens later.
When to Use
- Lead generation campaigns
- Collecting interest without immediate quotes
- Landing pages or forms where users express interest
- Scenarios where follow-up happens via email or phone
Integration Flow
Submit Lead
Call POST /api/v2/Partners/Lead with:
- Contact information (name, email)
- Vehicle information (VIN, Make/Model/Year, or License Plate)
- Vehicle location (state) and mileage
- Optional tracking parameters (UTM codes, transaction ID)
The API returns 200 OK when the lead is successfully received and queued for processing.
See the API Reference for complete endpoint details, schemas, required fields, and code examples.
Vehicle Identification
You must provide one of the following:
- VIN (17 characters)
- Make/Model/Year (all three required)
- License Plate (with state)
State and mileage are always required.
Next Steps
- Search Only — Display plan options with immediate quotes
- Live Flow — End-to-end purchase flow with pre-filled checkout
- Error Codes — Handle API errors gracefully