Skip to content
AutomotiveMCP
SchemasCore objects · C0RFC / v0.1

Employee

v0.1.0

A staff member or system user at a dealership — a salesperson, service advisor, technician, F&I manager, BDC agent, or manager. The Employee is the referent for the many actor pointers scattered across the standard: advisor_id on a Service Order, technician_id on a repair line, salesperson_id and fi_manager_id on a Deal, owner_id / assigned_to_id on a Lead, and assigned_to_id on an Activity Task all resolve to an Employee id. Employees also carry the crm_user_id and dms_user_id needed to reconcile the same person across the CRM and DMS. ADF/AutomotiveAPI lineage: the <salesperson>-style actor blocks ADF never formally typed are normalized here into a single first-class entity so agents can attribute and route work to a real, correlatable person.

Resourcescore.get_employeecore.list_employees

employee.example.jsonJSON
{
  "id": "b3f2c1a0-4d5e-4f6a-8b9c-0d1e2f3a4b5c",
  "source_ids": [
    {
      "system": "vinsolutions",
      "id": "VS-USER-88213",
      "sequence": 1
    },
    {
      "system": "cdk_drive",
      "id": "CDK-EMP-4471",
      "sequence": 2
    },
    {
      "system": "adp_payroll",
      "id": "ADP-000931",
      "sequence": 3
    }
  ],
  "dealer_id": "9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d",
  "name": {
    "first": "Marcus",
    "middle": "J",
    "last": "Delacroix",
    "suffix": "Jr."
  },
  "display_name": "Marcus D.",
  "status": "active",
  "department": "sales",
  "roles": [
    "salesperson",
    "sales_manager"
  ],
  "title": "General Sales Manager",
  "employee_number": "EMP-4471",
  "emails": [
    {
      "type": "work",
      "address": {
        "address": "marcus.delacroix@example-motors.com"
      },
      "is_primary": true
    },
    {
      "type": "personal",
      "address": {
        "address": "mjd.cars@example.com"
      }
    }
  ],
  "phones": [
    {
      "type": "mobile",
      "number": {
        "number": "+13135550142"
      },
      "is_primary": true
    },
    {
      "type": "desk_extension",
      "number": {
        "number": "+13135550100"
      },
      "extension": "217"
    }
  ],
  "reports_to_id": "1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
  "crm_user_id": "vs_user_88213",
  "dms_user_id": "cdk_mdelacroix",
  "is_sales_licensed": true,
  "sales_license_number": "MI-SP-0099231",
  "sales_license_state": "MI",
  "user_can_login": true,
  "avatar_url": "https://cdn.example-motors.com/staff/mdelacroix.jpg",
  "hire_date": "2019-03-11",
  "created_at": "2019-03-11T14:22:05Z",
  "updated_at": "2026-06-28T09:15:41Z",
  "extensions": {
    "com.vinsolutions.pay_plan_tier": "tier_3",
    "com.example.up_rotation_priority": 2
  }
}
Object shapes align with the AutomotiveAPI open data standard where sensible, and with the industry's ADF lead format — so a conformant server maps cleanly onto systems dealers already run.