Skip to content
AutomotiveMCP
SchemasLeads & CRM · R02RFC / v0.1

Customer

v0.1.0

A full person or business record for a shopper, buyer, or account in the dealership's CRM/DMS. Consolidates the identity, contact points, contactability preferences, consent links, and CRM enrichment (household, tags, segments, lifetime value) that many leads and deals reference. ADF only carried a lightweight <customer><contact> per lead; this entity is the durable, de-duplicated master record those leads resolve to, aligned with AutomotiveAPI-style CRM contact objects.

Resourcesleads.get_customerleads.search_customers
customer.example.jsonJSON
{
  "id": "9f1c2e7a-3b44-4d21-9a6e-7c0f5b2d8e10",
  "source_ids": [
    {
      "system": "elead",
      "id": "CUST-884213",
      "sequence": 1
    },
    {
      "system": "cdk_drive",
      "id": "0000884213",
      "sequence": 2
    }
  ],
  "type": "individual",
  "name": {
    "first": "Maria",
    "middle": "Elena",
    "last": "Vasquez",
    "suffix": "Jr"
  },
  "emails": [
    {
      "address": {
        "address": "maria.vasquez@example.com"
      },
      "type": "personal",
      "is_primary": true,
      "verified": true,
      "opt_status": "opted_in"
    },
    {
      "address": {
        "address": "mvasquez@northlandlogistics.com"
      },
      "type": "work",
      "is_primary": false,
      "verified": false,
      "opt_status": "unknown"
    }
  ],
  "phones": [
    {
      "number": {
        "number": "+13125550142"
      },
      "type": "mobile",
      "is_primary": true,
      "sms_capable": true,
      "sms_opt_status": "opted_in",
      "on_dnc": false,
      "verified": true
    },
    {
      "number": {
        "number": "+13125559981"
      },
      "type": "home",
      "is_primary": false,
      "sms_capable": false,
      "on_dnc": true,
      "verified": false,
      "extension": "204"
    }
  ],
  "addresses": [
    {
      "type": "home",
      "is_primary": true,
      "valid_from": "2019-03-01",
      "address": {
        "city": "Chicago",
        "region": "IL",
        "postal_code": "60657",
        "country": "US",
        "lines": [
          "482 W Belmont Ave",
          "Apt 3R"
        ]
      }
    }
  ],
  "date_of_birth": "1988-04-17",
  "gender": "female",
  "ssn_last4": "4821",
  "driver_license": {
    "number_last4": "9F42",
    "state": "IL",
    "country": "US",
    "expiration": "2028-04-17"
  },
  "preferred_contact": [
    "sms",
    "email",
    "phone"
  ],
  "preferred_contact_time": "evening",
  "preferred_language": "en",
  "timezone": "America/Chicago",
  "do_not_call": false,
  "do_not_email": false,
  "do_not_sms": false,
  "do_not_mail": true,
  "on_national_dnc": true,
  "email_opt_in": true,
  "sms_opt_in": true,
  "marketing_opt_out_all": false,
  "consent_ids": [
    "c2a1f8b0-7d34-4e19-9c22-1a5b6e3f0d77",
    "d3b2e9c1-8e45-4f2a-8d33-2b6c7f4a1e88"
  ],
  "source": {
    "channel": "third_party_lead",
    "name": "Cars.com",
    "source_id": {
      "system": "carsdotcom",
      "id": "LG-55231",
      "sequence": 1
    },
    "campaign_id": "e4c3f0d2-9f56-4a3b-9e44-3c7d8a5b2f99",
    "referrer_customer_id": "3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f"
  },
  "assigned_to": "cc33dd44-ee55-4f66-8a77-bb88cc99dd00",
  "dealer_id": "dd44ee55-ff66-4a77-9b88-cc99dd00ee11",
  "lead_ids": [
    "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
    "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e"
  ],
  "household_id": "7c8d9e0f-1a2b-4c3d-8e4f-5a6b7c8d9e0f",
  "tags": [
    "vip",
    "prior_owner",
    "spanish_preferred"
  ],
  "segments": [
    "in_market_ev",
    "lease_maturing_90d"
  ],
  "lifetime_value": {
    "amount": 48250.75,
    "currency": "USD"
  },
  "credit_score_band": "prime",
  "status": "active",
  "first_seen_at": "2021-06-14T15:32:00Z",
  "last_activity_at": "2026-06-27T19:04:11Z",
  "created_at": "2021-06-14T15:32:00Z",
  "updated_at": "2026-06-28T08:12:45Z",
  "created_by": "aa11bb22-cc33-4d44-8e55-ff66aa77bb88",
  "updated_by": "bb22cc33-dd44-4e55-9f66-aa77bb88cc99",
  "extensions": {
    "acme_crm:score": 87,
    "acme_crm:equity_position": "positive"
  }
}
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.