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

Activity / Task

v0.1.0

A CRM activity or task — a logged interaction (call, email, text, note, visit, voicemail, chat) or a scheduled to-do (task) — recorded against a lead, customer, deal, service order, or appointment. Modernizes the interaction-logging implied by ADF's request/response lifecycle and the follow-up/communication history in the STAR/AutomotiveAPI CRM domain into a typed, first-class record that AI agents can read, create, and update.

Resourcesleads.get_activityleads.create_activityleads.list_activities
activity-task.example.jsonJSON
{
  "id": "b3f1c2a4-8d7e-4c1a-9f2b-6e5d4c3b2a10",
  "source_ids": [
    {
      "system": "crm",
      "id": "ACT-0098231",
      "sequence": 1
    },
    {
      "system": "cti_telephony",
      "id": "call_9f83ac21b7",
      "sequence": 2
    }
  ],
  "type": "call",
  "direction": "outbound",
  "channel": "phone",
  "subject": "Follow-up on 2024 RAV4 XLE internet inquiry",
  "body": "Called customer to follow up on her web lead for the 2024 RAV4 XLE (VIN JTMRWRFV5RD012345). Confirmed she is cross-shopping the CR-V. Discussed current lease-loyalty offer and available inventory. She is interested in a Saturday test drive and wants a trade estimate on her 2019 Camry.",
  "status": "completed",
  "priority": "high",
  "scheduled_at": "2026-06-29T15:00:00-04:00",
  "start_at": "2026-06-29T15:02:11-04:00",
  "end_at": "2026-06-29T15:14:47-04:00",
  "completed_at": "2026-06-29T15:14:47-04:00",
  "duration_seconds": 756,
  "owner_id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "assigned_by_id": "7c6d5e4f-3a2b-4c1d-8e9f-0a1b2c3d4e5f",
  "team_id": "5f4e3d2c-1b0a-4938-8271-615243546677",
  "dealer_id": "0e1d2c3b-4a59-4867-9243-a1b2c3d4e5f6",
  "participant_ids": [
    "9f8e7d6c-5b4a-4938-8271-6152435465ff"
  ],
  "related_to": {
    "type": "lead",
    "id": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f70",
    "label": "Web lead — Maria Alvarez — RAV4 XLE"
  },
  "related_records": [
    {
      "type": "vehicle",
      "id": "aa11bb22-cc33-4d44-9e55-ff6677889900",
      "label": "2024 Toyota RAV4 XLE — JTMRWRFV5RD012345"
    },
    {
      "type": "appointment",
      "id": "bb22cc33-dd44-4e55-8f66-001122334455",
      "label": "Saturday 10:00 test drive"
    }
  ],
  "contact": {
    "phone": {
      "number": "+13055551234"
    },
    "email": {
      "address": "maria.alvarez@example.com"
    },
    "name": {
      "first": "Maria",
      "last": "Alvarez"
    }
  },
  "outcome": "Connected with decision maker; strong interest, scheduling a test drive and trade appraisal.",
  "disposition": "connected",
  "sentiment": "positive",
  "recording_url": "https://recordings.example-cti.com/calls/9f83ac21b7.mp3",
  "transcript": "Agent: Hi Maria, this is Sam from Sunrise Toyota following up on your RAV4 inquiry...",
  "call_detail": {
    "provider_call_id": "CA9f83ac21b7d4e5f6a7b8c9d0e1f2a3b",
    "from_number": {
      "number": "+13055559876"
    },
    "to_number": {
      "number": "+13055551234"
    },
    "tracking_number": {
      "number": "+18005551000"
    },
    "ring_seconds": 6,
    "talk_seconds": 750,
    "hold_seconds": 0,
    "answered": true,
    "voicemail_left": false
  },
  "attachments": [
    {
      "url": "https://files.example-crm.com/activities/ACT-0098231/rav4-window-sticker.pdf",
      "filename": "rav4-window-sticker.pdf",
      "content_type": "application/pdf",
      "size_bytes": 184320
    }
  ],
  "consent": {
    "status": "opted_in",
    "channel": "phone",
    "obtained_at": "2026-06-20T18:12:00-04:00",
    "source": "web_form",
    "do_not_call": false
  },
  "campaign_id": "c1c2c3c4-d5d6-4e7f-8a9b-0c1d2e3f4a5b",
  "tags": [
    "hot-lead",
    "trade-in",
    "conquest"
  ],
  "automated": false,
  "next_action": {
    "description": "Send RAV4 XLE window sticker and lease-loyalty quote by email, then confirm Saturday 10:00 test drive.",
    "type": "email",
    "due_at": "2026-07-01T17:00:00-04:00",
    "assigned_to_id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
  },
  "created_at": "2026-06-29T15:15:02-04:00",
  "updated_at": "2026-06-29T15:15:02-04:00",
  "created_by": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "updated_by": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "extensions": {
    "acme.call_campaign_id": "spring-conquest-2026",
    "acme.crm_pipeline_stage": "test_drive_scheduled"
  }
}
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.