Supergood | Auto/Mate DMS API

Supergood | Auto/Mate DMS API

Programmatically access Auto/Mate DMS dealership data, sales/F&I workflows, service operations, and accounting artifacts with a stable REST API. Supergood builds and operates production-grade, unofficial Auto/Mate integrations so your team can automate onboarding, sync inventory, and power dealer-facing features without heavy custom engineering.

Plain English: Auto/Mate DMS is dealership management software (now part of Solera) used by auto dealers to run sales, F&I, service, parts, and accounting. An unofficial API lets you pull vehicle inventory, customers, deals, service appointments and repair orders, and accounting summaries—and push new leads/customers, create deals, schedule service, and update statuses.

For a tech company integrating with Auto/Mate, this means you can ingest live inventory to power merchandising, create and advance deals from your digital retailing flow, schedule and manage service appointments from your app, and reconcile delivered deals and receipts to your ERP. You can also enrich your platform with RO details, parts availability, and F&I product selections, while keeping the DMS as the system of record.

What is Auto/Mate DMS?

Auto/Mate (https://automate.com/) is a dealer management system for franchised and independent auto dealerships. It centralizes core retail operations across variable ops (sales/F&I), fixed ops (service and parts), and accounting.

Core product areas include:

  • Sales & F&I (e.g., desking, deal jackets, lender decisions, F&I products)
  • Vehicle Inventory (e.g., acquisition, pricing, photo management, aging)
  • Fixed Operations (e.g., service appointments, repair orders, op codes, parts)
  • Accounting & Reporting (e.g., GL, AR/AP, deposits, schedules, deal recaps)
  • CRM & Communications (e.g., customers, leads, follow-ups; often integrated)

Common data entities:

  • Dealerships, Rooftops, Users, and Permissions
  • Vehicles (VIN, stock number, pricing, status)
  • Customers (retail/fleet, contacts, addresses, preferences)
  • Deals (desking data, trade-ins, taxes/fees, products, delivery)
  • Service Appointments and Repair Orders (op codes, labor, parts, statuses)
  • Parts Inventory and Tickets
  • Accounting Objects (GL accounts, journal entries, receipts, deal recaps)

The Auto/Mate Integration Challenge

DMS platforms are mission-critical but difficult to automate programmatically:

  • Siloed modules and entitlements: Sales, service, parts, and accounting each enforce different permissions and approval flows
  • Portal-first design: Many capabilities are optimized for the desktop client or browser UI with limited vendor endpoints
  • Dealer-specific configuration: Chart of accounts, fees, taxes, op codes, and product catalogs vary by rooftop
  • Hybrid auth: Username/password with possible SSO/MFA and session-dependent navigation
  • Financial rigor: Posting deals and ROs must honor approval states, audit requirements, and OEM compliance

How Supergood Creates Auto/Mate APIs

Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your Auto/Mate tenant.

  • Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
  • Maintains session continuity with automated refresh and change detection
  • Normalizes responses so you can integrate once and rely on consistent objects across modules
  • Aligns with customer entitlements and role-based permissions to ensure compliant access
  • Safely executes stateful actions (e.g., posting deals, opening/closing ROs) with queueing and idempotency

Use Cases

Inventory and Merchandising Sync

  • Mirror vehicles (VIN, pricing, photos, status) into your product for websites and marketplaces
  • Update pricing, photos, and comments from your platform while respecting DMS validations
  • Track aging and status changes (in-stock, retail sold, wholesale) for ad optimization

Digital Retail and Deal Desk

  • Create deals from online checkout flows with pencils, rebates, and F&I products
  • Update deal status (penciled → contracted → delivered) and capture lender terms
  • Pull deal recaps for reconciliation and customer communication

Service Scheduling and RO Automation

  • Schedule service appointments with op codes and customer concerns from your app
  • Generate repair orders, attach MPI results, and update statuses programmatically
  • Keep advisors, technicians, and customers in sync with notifications and SLAs

Accounting and Reconciliation

  • Pull delivered deals, receipts, and deposit summaries for nightly reconciliation
  • Map dealer-specific GL accounts and export normalized entries to your ERP
  • Detect mismatches (fees, taxes, down payments) and trigger follow-ups

Available Endpoints

Authentication

POST /sessions: Establish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/sessions \
  --header 'Authorization: Basic <Base64 encoded token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "[email protected]",
    "password": "<password>",
    "mfa": { "type": "totp", "code": "123456" }
  }'

Example response

{
  "authToken": "eyJhbGciOi...",
  "expiresIn": 3600,
  "user": {
    "id": "u_7b21f0",
    "name": "General Manager",
    "entitlements": ["inventory", "sales", "service", "accounting"]
  }
}

POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.

Vehicles

GET /vehicles: List vehicles with filters and summary details.

Query parameters

  • status: in_stock | retail_sold | wholesale | transit
  • condition: new | used | certified
  • make, model, vin: strings
  • lotId: string
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "vehicleId": "veh_28f93a",
      "vin": "1HGCM82633A004352",
      "stockNumber": "A12345",
      "status": "in_stock",
      "condition": "used",
      "year": 2021,
      "make": "Honda",
      "model": "Accord",
      "trim": "EX-L",
      "bodyStyle": "Sedan",
      "exteriorColor": "White",
      "interiorColor": "Black",
      "odometer": {"value": 23875, "unit": "mi"},
      "msrp": 0,
      "listPrice": 25995.00,
      "salePrice": 24995.00,
      "cost": 22000.00,
      "isWholesale": false,
      "agingDays": 18,
      "lot": {"lotId": "lot_01", "name": "Main Lot"},
      "photos": [
        {"url": "https://images.example.com/veh_28f93a/1.jpg"},
        {"url": "https://images.example.com/veh_28f93a/2.jpg"}
      ],
      "fuelType": "Gasoline",
      "transmission": "Automatic",
      "driveType": "FWD",
      "engine": "1.5L I4 Turbo",
      "acquisitionDate": "2025-12-28",
      "updatedAt": "2026-01-20T13:45:00Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Customers

POST /customers: Create or update a customer (lead, retail, or fleet). Upsert is supported via externalId or matching on name + contact info.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/customers \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "externalId": "lead_9f21a",
    "customerType": "retail",
    "firstName": "Ava",
    "lastName": "Martinez",
    "emails": ["[email protected]"],
    "phones": [
      {"type": "mobile", "number": "+15551234567"}
    ],
    "address": {
      "line1": "500 Elm St",
      "city": "Buffalo",
      "region": "NY",
      "postalCode": "14201",
      "country": "US"
    },
    "driversLicense": {"number": "M1234567", "state": "NY"},
    "dateOfBirth": "1992-03-04",
    "marketingOptIn": {"email": true, "sms": true, "phone": false},
    "source": "Website Form",
    "notes": "Interested in Accord, prefers weekends."
  }'

Example response

{
  "customerId": "cust_5c01e8",
  "status": "upserted",
  "matchedBy": "externalId",
  "updatedAt": "2026-01-21T09:12:33Z"
}

Deals

POST /deals: Create a new deal record (penciled) with desking details, trade-in, and preliminary F&I products.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/deals \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "referenceId": "webcheckout-8821",
    "customerId": "cust_5c01e8",
    "vehicle": {"vin": "1HGCM82633A004352"},
    "pricing": {
      "salePrice": 24995.00,
      "discounts": 500.00,
      "rebates": 1000.00
    },
    "tradeIn": {
      "vin": "2FMPK4K82KBB12345",
      "acv": 8000.00,
      "payoff": 9500.00,
      "lienholder": "ABC Credit Union"
    },
    "finance": {
      "cashDown": 2000.00,
      "termMonths": 60,
      "aprPercent": 5.49,
      "lenderCode": "ALLY",
      "products": [
        {"code": "VSC", "name": "Service Contract", "price": 1495.00},
        {"code": "GAP", "name": "GAP Coverage", "price": 695.00}
      ]
    },
    "fees": [
      {"code": "DOC", "description": "Doc Fee", "amount": 175.00},
      {"code": "REG", "description": "Registration", "amount": 180.00}
    ],
    "taxes": {"ratePercent": 8.75},
    "salespersonId": "u_2a9b7c",
    "fniManagerId": null,
    "status": "penciled"
  }'

Example response

{
  "dealId": "deal_61df30",
  "dealNumber": "D-2026-00128",
  "status": "penciled",
  "createdAt": "2026-01-21T10:03:11Z"
}

Service Appointments

POST /service/appointments: Create a service appointment with op codes and advisor assignment.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/service/appointments \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "customerId": "cust_5c01e8",
    "vin": "1HGCM82633A004352",
    "appointmentTime": "2026-02-02T14:30:00-05:00",
    "advisorId": "u_advisor_01",
    "opCodes": [
      {"code": "LOF", "description": "Lube, Oil & Filter", "laborHours": 0.5},
      {"code": "TIRE_ROT", "description": "Tire Rotation", "laborHours": 0.3}
    ],
    "concern": "Oil change and rotation before road trip",
    "transportation": "shuttle",
    "notes": "Customer will wait on-site"
  }'

Example response

{
  "appointmentId": "appt_9fa201",
  "status": "scheduled",
  "department": "service",
  "createdAt": "2026-01-21T11:20:44Z"
}

Get full API Specs →


Technical Specifications

  • Authentication: Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
  • Response format: JSON with consistent resource schemas and pagination across modules
  • Rate limits: Tuned for high-volume inventory, deal, and service sync while honoring entitlements and usage controls
  • Session management: Automatic reauth and cookie/session rotation with health checks
  • Data freshness: Near real-time retrieval of vehicles, customers, deals, appointments, and ROs
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Auto/Mate role-based permissions and approval gates
  • Webhooks: Optional asynchronous delivery for long-running workflows (e.g., deal posting, RO close-out)

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume inventory exports and appointment/deal creation
  • Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
  • Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates

Getting Started

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your modules, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened Auto/Mate adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as Auto/Mate evolves.

Schedule Integration Call →


Frequently Asked Questions

Q: Which Auto/Mate modules can this integration cover?

Supergood supports workflows across commonly used modules such as Sales & F&I (deals, products), Vehicle Inventory, Fixed Ops (service appointments, repair orders), and Accounting (deal recaps, receipts), subject to your licensing and entitlements. We scope coverage during integration assessment.

Q: How are MFA and SSO handled for automation?

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.

Q: Can you create deals from our digital retailing flow and update status on delivery?

Yes. We can create penciled deals, apply trade-ins, taxes/fees, and F&I products, then advance status to contracted/delivered once approvals are met. We also return deal numbers and recaps for reconciliation.

Q: Do you support attachments (e.g., RO PDFs, driver’s license images)?

Yes. We support downloading artifacts and uploading attachments via signed uploads with checksum validation and time-limited URLs where supported by the tenant’s configuration.

Q: Can you reconcile accounting data to our ERP?

We can normalize delivered deals, receipts, and deposit summaries, map dealer-specific GL accounts, and send updates via webhooks or polling while complying with rate and permission constraints.


Dealertrack API - Programmatically access Dealertrack DMS and lender workflows with Supergood


Ready to automate your Auto/Mate workflows?

Supergood can have your Auto/Mate integration live in days with no ongoing engineering maintenance.

Get Started →

Read more