Supergood | DealerSocket DMS API
Programmatically access DealerSocket DMS dealership data, workflows, and financials with a stable REST API. Supergood builds and operates production-grade, unofficial DealerSocket DMS integrations so your team can automate sales, service, parts, and accounting workflows without heavy custom engineering.
Plain English: DealerSocket DMS is dealership management software used by automotive retailers to run day-to-day operations across Sales & F&I, Service, Parts, Accounting, and Inventory. An unofficial API lets you pull vehicles, customers, deals, repair orders, parts tickets, and accounting summaries—and push new deals, service appointments, RO status changes, payments, and inventory updates back into the DMS.
For a tech company selling into car dealerships, this means you can ingest real-time inventory and customer profiles to power digital retailing, create and update deals from your quoting flows, automate service scheduling and RO lifecycle updates, sync payments and invoices to your accounting, and keep multi-rooftop operations unified in your platform. You can push leads and appointments, attach deal forms, track delivery and service events, and ensure your dealership customers onboard in days—not months.
What is DealerSocket DMS?
DealerSocket DMS (https://dealersocket.com/) is a cloud platform for automotive dealership operations that centralizes sales, F&I, service, parts, and accounting functions. Teams use DealerSocket DMS to manage vehicle inventory, desk and contract deals, process payments, create and track repair orders, manage parts and purchasing, and reconcile financials across one or more rooftops.
Core product areas include:
- Sales & F&I (e.g., desking, lender submissions, contracting, trade-ins)
- Service (e.g., appointments, repair orders, labor ops, technician time)
- Parts (e.g., parts tickets, inventory, purchase orders, vendors)
- Accounting & GL (e.g., daily DOC, journal entries, receivables/payables)
- Inventory & Vehicles (e.g., unit records, pricing, aging, photos)
- Reporting & OEM Compliance (e.g., forms, certified integrations)
Common data entities:
- Dealerships, Stores, Users, and Roles/Permissions
- Customers (profiles, contact info, consent flags)
- Vehicles & Inventory (VIN, stock number, status, pricing)
- Deals & Contracts (cash/finance/lease, F&I products, taxes/fees)
- Repair Orders (labor ops, parts lines, statuses, promised times)
- Parts Tickets, Purchase Orders, Vendors
- Payments, Invoices, GL Accounts, Journal Entries
The DealerSocket DMS Integration Challenge
Dealerships rely on DMS workflows daily, but automating portal-first processes isn’t trivial:
- Module-specific interfaces: Sales & F&I, Service, Parts, and Accounting each expose distinct UIs, data models, and entitlements
- Enterprise security: SSO, MFA, and tight role-based controls complicate headless automation
- Portal-first features: Many capabilities are optimized for the web app, with data spread across screens and exports
- Financial and regulatory rigor: Audit trails, approval chains, forms, and OEM compliance must be respected programmatically
- Multi-rooftop complexity: Store-specific settings, numbering sequences, and calendars need careful normalization
How Supergood Creates DealerSocket DMS APIs
Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your DealerSocket DMS 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
- Supports multi-store routing and context selection for rooftop-specific operations
Use Cases
Inventory and Customer Data Sync
- Mirror vehicles, customers, and users into your internal systems
- Keep inventory statuses, pricing, and photos current for digital retailing and analytics
- Normalize contact data, opt-ins, and store context for multi-tenant operations
Digital Retailing & Deal Desk Automation
- Create deals from your quoting flows with taxes, fees, trade-ins, and lender terms
- Attach forms (e.g., buyer’s order) and push contracted deals back to the DMS
- Trigger approval workflows and keep payment estimates and lender selections in sync
Service Lane & Repair Orders
- Ingest repair orders and statuses to drive customer communication and SLAs
- Create service appointments programmatically and assign advisors/technicians
- Track parts/labor lines, promised times, and completion to power workflow automation
Accounting & Reconciliation
- Sync payments, invoices, and summaries to your ERP (e.g., NetSuite, QuickBooks)
- Pull daily DOC metrics and journal entries to reconcile postings
- Respect store calendars, numbering sequences, and permissioned GL access
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_1f92a0",
"name": "General Manager",
"stores": ["store_alm-01", "store_alm-02"],
"entitlements": ["inventory", "sales", "service", "parts", "accounting"]
}
}
POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.
Vehicles (Inventory)
GET /inventory/vehicles: List vehicle inventory with filters and summary details.
Query parameters
- storeId: string
- status: available | hold | sold | wholesale
- make, model: strings
- yearFrom, yearTo: integers
- updatedFrom, updatedTo: ISO 8601 timestamps
- page, pageSize: integers for pagination
Example response
{
"items": [
{
"vehicleId": "veh_7c21aa",
"vin": "1HGCM82633A123456",
"stockNumber": "A12345",
"year": 2023,
"make": "Honda",
"model": "Accord",
"trim": "EX-L",
"status": "available",
"retailPrice": 28995.00,
"internetPrice": 27995.00,
"cost": 24500.00,
"mileage": 12500,
"bodyStyle": "Sedan",
"exteriorColor": "Blue",
"interiorColor": "Black",
"fuelType": "Gasoline",
"transmission": "Automatic",
"lotId": "lot_main",
"photoUrls": [
"https://cdn.yourco.com/photos/veh_7c21aa/front.jpg"
],
"agingDays": 18,
"updatedAt": "2026-01-20T13:45:00Z"
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
Sales Deals
POST /sales/deals: Create a new sales deal (cash/finance/lease) with pricing, trade-in, taxes/fees, and optional F&I products.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/sales/deals \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"storeId": "store_alm-01",
"type": "finance",
"customerId": "cust_45af1d",
"vehicleId": "veh_7c21aa",
"pricing": {
"salePrice": 27995.00,
"docFee": 399.00,
"taxRate": 0.0825,
"rebates": 500.00
},
"tradeIn": {
"vin": "2C4RC1BG9LR123999",
"value": 8000.00,
"payoffAmount": 9200.00
},
"finance": {
"lenderId": "lend_ally",
"apr": 6.49,
"termMonths": 72,
"estimatedPayment": 475.33
},
"fAndIProducts": [
{"code": "VSC_60M", "description": "Vehicle Service Contract 60M", "price": 1395.00},
{"code": "TIRE_ROAD", "description": "Tire & Road Hazard", "price": 299.00}
],
"attachments": [
{"fileName": "buyers-order.pdf", "uploadToken": "upl_08ab73"}
],
"referenceId": "quote-8793"
}'
Example response
{
"dealId": "deal_90e412",
"status": "pending",
"dealNumber": "D-2026-00128",
"storeId": "store_alm-01",
"createdAt": "2026-01-21T10:03:11Z"
}
Service Repair Orders
POST /service/repair-orders: Create a repair order with customer/vehicle context, labor ops, parts lines, and promised time.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/service/repair-orders \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"storeId": "store_alm-01",
"customerId": "cust_92b711",
"vehicleVin": "1HGCM82633A123456",
"mileageIn": 12600,
"serviceAdvisorId": "u_45af1d",
"complaint": "Oil change and tire rotation",
"promisedTime": "2026-01-22T16:30:00Z",
"laborOps": [
{"opCode": "LOF", "description": "Lube, Oil, Filter", "hours": 0.5, "rate": 120.00},
{"opCode": "TR", "description": "Tire Rotation", "hours": 0.3, "rate": 120.00}
],
"parts": [
{"partNumber": "FILTER-1234", "description": "Oil Filter", "qty": 1, "price": 19.95},
{"partNumber": "OIL-5W30", "description": "Synthetic Oil 5W-30", "qty": 5, "price": 8.50}
],
"notes": "Customer waiting"
}'
Example response
{
"roId": "ro_51af80",
"roNumber": "RO-2026-00451",
"status": "open",
"storeId": "store_alm-01",
"totals": {
"laborTotal": 96.00,
"partsTotal": 62.45,
"shopSupplies": 6.00,
"tax": 7.50,
"grandTotal": 171.95
},
"createdAt": "2026-01-21T11:20:44Z"
}
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 dealership throughput while honoring customer entitlements and usage controls
- Session management: Automatic reauth and cookie/session rotation with health checks
- Data freshness: Near real-time retrieval of inventory, deals, repair orders, parts tickets, and accounting summaries
- Security: Encrypted transport, scoped tokens, and audit logging; respects DMS role-based permissions and store contexts
- Webhooks: Optional asynchronous delivery for long-running workflows (e.g., deal approvals, RO status changes)
Performance Characteristics
- Latency: Sub-second responses for list/detail queries under normal load
- Throughput: Designed for high-volume inventory sync, deal creation, and RO processing
- Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
- Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened DealerSocket DMS adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as DealerSocket DMS evolves.
Frequently Asked Questions
Q: Which DealerSocket DMS modules can this integration cover?
Supergood supports workflows across commonly used modules such as Sales & F&I (deals, contracting), Service (appointments, repair orders), Parts (parts tickets, inventory), Accounting (DOC summaries, journal entry retrieval), and Inventory (vehicles), 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 sync deals and service invoices to our ERP?
Yes. We can normalize deals, RO totals, and payments to match your ERP schema (e.g., line items, taxes, fees) and deliver updates via webhooks or polling while complying with rate and permission constraints.
Q: Are attachments supported for deals and repair orders?
Yes. We support downloading artifacts and uploading attachments via signed uploads, with checksum validation and time-limited URLs.
Related Integrations
Dealertrack API - Programmatically access Dealertrack with Supergood
Ready to automate your DealerSocket DMS workflows?
Supergood can have your DealerSocket DMS integration live in days with no ongoing engineering maintenance.
