Skip to content
DriveAgent
Documentation Menu

Tools

Quick Start

Get your first vehicle published to DriveAgent in under 5 minutes.

What you need

  1. A Bearer token (provided during onboarding)
  2. Your Seller.Identifier (your dealership ID — we map it to the correct feed on our end)
  3. Vehicle data in JSON format

Send your first vehicle

Make an HTTP POST to the ingest endpoint with your vehicle data:

curl -X POST https://ingest.driveagent.io/api/ingest \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -d '{
    "Type": "CAR",
    "Identifier": 12345,
    "ListingType": "used",
    "SaleStatus": "For Sale",
    "SaleType": "Retail",
    "Description": "Well maintained vehicle in excellent condition.",
    "Identification": [
      { "Type": "StockNumber", "Value": "STK001" },
      { "Type": "VIN", "Value": "WBAPH5C55BA123456" }
    ],
    "Seller": {
      "Identifier": "your-guid-seller-id",
      "Type": "Dealer",
      "Name": "Your Dealership"
    },
    "Specification": {
      "Make": "Toyota",
      "Model": "Hilux",
      "Attributes": [
        { "Name": "Badge", "Value": "SR5" },
        { "Name": "Transmission", "Value": "Automatic" },
        { "Name": "FuelType", "Value": "Diesel" },
        { "Name": "BodyStyle", "Value": "Dual Cab Ute" }
      ]
    },
    "BuildDate": { "Year": 2024 },
    "PriceList": [
      { "Type": "DAP", "Currency": "AUD", "Amount": 62990 }
    ],
    "Media": {
      "Photos": [
        { "Url": "https://example.com/photo1.jpg" }
      ]
    }
  }'

What you get back

A successful response (HTTP 200) includes:

{
  "success": "200 - Data received and processed",
  "supabase": { "success": true },
  "fields": {
    "mapped": 18,
    "total": 43,
    "details": {
      "make": "Toyota",
      "model": "Hilux",
      "transmission": "Automatic",
      ...
    }
  }
}

The fields object tells you exactly how much of your data mapped. Aim for the highest coverage possible — null fields mean data your listing is missing.

Try it interactively

Use the Sandbox to test payloads in your browser with pre-built examples and instant feedback.

Next steps