Communication
v0.1.0A single message or call exchanged between a dealership and a customer/prospect. A Communication is the concrete artifact of an interaction (the email that was sent, the SMS delivered, the phone call recorded), and is distinct from an Activity or Task, which merely LOG that an interaction occurred. Communications capture the full envelope (from/to/cc/bcc/reply_to), content (subject/body/body_html), transport metadata (provider, thread, in_reply_to, delivery timestamps, error codes), channel-specific detail (call recording/transcript/disposition), engagement events (opens/clicks), messaging cost, and the compliance basis for outbound contact (consent_id). Lineage: email/subject/body map to ADF <contact> and CRM email records; direction/channel/status/error_code/segment_count align with common telephony and messaging provider webhooks (e.g. Twilio Message/Call resources, SendGrid Event Webhook, RingCentral) as normalized through AutomotiveAPI-style CRM adapters. The TCPA/CAN-SPAM/CASL compliance basis for outbound contact references a Consent record via consent_id.
leads.get_communicationleads.list_communicationsleads.send_message{
"id": "a1b2c3d4-0001-4a2b-8c3d-000000000001",
"source_ids": [
{
"system": "crm",
"id": "COMM-88213"
},
{
"system": "sendgrid",
"id": "sg-01H9Z3K4"
}
],
"direction": "outbound",
"channel": "email",
"status": "read",
"priority": "normal",
"customer_id": "c0ffee00-0002-4a2b-8c3d-000000000002",
"lead_id": "1eadc0de-0003-4a2b-8c3d-000000000003",
"deal_id": "dea10001-0004-4a2b-8c3d-000000000004",
"campaign_id": "ca119a1e-0008-4a2b-8c3d-000000000008",
"agent_id": "a9e17001-0005-4a2b-8c3d-000000000005",
"dealership_id": "dea1e5ec-0009-4a2b-8c3d-000000000009",
"from": {
"name": {
"full": "Priya Desai - Cobalt Motors"
},
"address": "priya.desai@cobaltmotors.example"
},
"reply_to": {
"name": {
"full": "Cobalt Motors Sales"
},
"address": "sales@cobaltmotors.example"
},
"to": [
{
"name": {
"full": "Jordan Buyer"
},
"address": "jordan.buyer@example.com"
}
],
"cc": [
{
"name": {
"full": "Cobalt BDC"
},
"address": "bdc@cobaltmotors.example"
}
],
"bcc": [
{
"name": {
"full": "CRM Journal"
},
"address": "journal@crm.cobaltmotors.example"
}
],
"subject": "Your quote on the 2026 Cobalt EX AWD",
"body": "Hi Jordan,\n\nGreat meeting you today. Attached is the quote we discussed on the 2026 Cobalt EX AWD, including your trade estimate. Let me know if 3pm Thursday works for delivery.\n\nBest,\nPriya",
"body_html": "<p>Hi Jordan,</p><p>Great meeting you today. Attached is the quote we discussed on the <strong>2026 Cobalt EX AWD</strong>, including your trade estimate. Let me know if 3pm Thursday works for delivery.</p><p>Best,<br>Priya</p>",
"template_id": "quote-followup-v3",
"language": "en-US",
"attachments": [
{
"name": "cobalt-ex-awd-quote.pdf",
"url": "https://files.cobaltmotors.example/quotes/cobalt-ex-awd-quote.pdf?sig=abc123",
"mime_type": "application/pdf",
"size_bytes": 184320
}
],
"provider": {
"name": "sendgrid",
"message_id": "sg-01H9Z3K4M5N6P7Q8R9S0T1U2V3",
"account_id": "acct_cobalt_01"
},
"thread_id": "7f4eadbb-0006-4a2b-8c3d-000000000006",
"in_reply_to": "b2c3d4e5-000a-4a2b-8c3d-00000000000a",
"sent_at": "2026-06-29T15:04:22Z",
"delivered_at": "2026-06-29T15:04:29Z",
"read_at": "2026-06-29T18:41:10Z",
"opens": 3,
"clicks": 1,
"cost": {
"amount": 0.00095,
"currency": "USD"
},
"consent_id": "c05e7100-0007-4a2b-8c3d-000000000007",
"is_automated": false,
"tags": [
"quote-followup",
"ev"
],
"created_at": "2026-06-29T15:04:20Z",
"updated_at": "2026-06-29T18:41:11Z",
"extensions": {
"campaign_id": "spring-ev-2026",
"ab_variant": "B"
}
}