Partner API

https://dealercrm.com/partner/v1

Authorization: Bearer dcp_live_xxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

curl https://dealercrm.com/partner/v1/ping \
  -H "Authorization: Bearer $DEALERCRM_KEY"

curl "https://dealercrm.com/partner/v1/customers?limit=50" \
  -H "Authorization: Bearer $DEALERCRM_KEY"

{
  "object": "list",
  "items": [
    { "customer_id": 10000001, "first_name": "Jane", "last_name": "Doe",
      "full_name": "Jane Doe", "email": "jane@example.com",
      "phone_mobile": "3105551234", "do_not_contact": false,
      "preferred_contact_channel": "sms",
      "point_person": { "id": 42, "name": "Alex Rivera" },
      "customer_since": "2025-03-01", "created": 1740787200 }
  ],
  "next_cursor": 10000001,
  "limit": 50
}

curl "https://dealercrm.com/partner/v1/inventory?status=active&limit=25" \
  -H "Authorization: Bearer $DEALERCRM_KEY"

{ "object":"list", "items":[
  { "inventory_id": 139450, "year": 2024, "make": "Ford", "model": "F-150",
    "trim": "XLT", "vin": "1FTFW1E86PKE00000", "stock_number": "A1234",
    "condition": "new", "mileage": 12, "ext_color": "Oxford White",
    "msrp": 58230, "asking_price": 55990, "internet_price": 54990,
    "sale_status_type": 1, "primary_image_url": "https://…",
    "updated": "2026-07-09T16:15:49Z" }
], "next_cursor": 139450, "limit": 25, "status": "active" }

curl "https://dealercrm.com/partner/v1/activities?customer_id=10000001&limit=20" \
  -H "Authorization: Bearer $DEALERCRM_KEY"

curl -X POST https://dealercrm.com/partner/v1/leads \
  -H "Authorization: Bearer $DEALERCRM_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: acme-lead-9931" \
  -d '{
    "customer": { "full": "Jane Doe", "email": "jane@example.com", "phone": "310-555-1234" },
    "vehicle":  { "year": 2024, "make": "Ford", "model": "F-150", "vin": "1FTFW1E86PKE00000" },
    "trade":    { "year": 2019, "make": "Toyota", "model": "Camry" },
    "intent": "sales",
    "source": "Acme Marketing",
    "consent": { "sms_optin": true },
    "store_account_id": 1
  }'

{ "object":"lead", "lead_id": 812, "customer_id": 10000042,
  "activity_id": 48500441, "dedup_method": "new_customer",
  "intent": "sales", "is_existing_customer": false }

curl -X POST https://dealercrm.com/partner/v1/customers \
  -H "Authorization: Bearer $DEALERCRM_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "full_name": "Jane Doe", "email": "jane@example.com", "phone": "3105551234" }'

{ "object":"customer", "customer_id": 10000042, "created": true, "dedup_method": null }

curl -X POST https://dealercrm.com/partner/v1/activities \
  -H "Authorization: Bearer $DEALERCRM_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: calltrack-8891" \
  -d '{
    "customer_id": 10000042,
    "kind": "call_inbound",
    "duration_seconds": 214,
    "outcome": "connected",
    "from": "+13105551234", "to": "+13235550100",
    "recording_url": "https://calls.example.com/rec/8891.mp3",
    "transcript": "Customer: Is the F-150 still available?\nAgent: Yes — want to come see it Saturday?",
    "employee_name": "Alex Rivera",
    "occurred_at": "2026-07-09T18:30:00Z",
    "meta": { "call_score": 92, "sentiment": "positive" }
  }'

curl -X POST https://dealercrm.com/partner/v1/activities \
  -H "Authorization: Bearer $DEALERCRM_KEY" -H "Content-Type: application/json" \
  -d '{ "email": "jane@example.com", "kind": "email_outbound",
        "subject": "Your F-150 is waiting", "campaign": "July Truck Event",
        "outcome": "sent", "body": "Hi Jane — the truck you looked at is still here." }'

curl -X POST https://dealercrm.com/partner/v1/activities \
  -H "Authorization: Bearer $DEALERCRM_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: appraise-5521" \
  -d '{
    "email": "jane@example.com",
    "kind": "appraisal",
    "amount": 18500,
    "reference": "ICO-5521",
    "vehicle": { "year": 2021, "make": "Toyota", "model": "RAV4", "vin": "2T3P1RFV5MW000000" },
    "body": "Instant cash offer, valid 7 days. Clean CARFAX, 2 keys.",
    "employee_name": "Appraisal Bot",
    "meta": { "book": "ICO", "condition": "clean", "expires": "2026-07-16" }
  }'

curl -X POST https://dealercrm.com/partner/v1/activities \
  -H "Authorization: Bearer $DEALERCRM_KEY" -H "Content-Type: application/json" \
  -d '{ "customer_id": 10000042, "kind": "appointment",
        "scheduled_at": "2026-07-12T15:00:00Z", "appointment_type": "meeting",
        "appointment_status": "confirmed", "employee_name": "BDC — Sam",
        "body": "Confirmed Saturday 11am to see the RAV4." }'

# A real-time inventory system tells us a unit just sold:
curl -X POST https://dealercrm.com/partner/v1/inventory \
  -H "Authorization: Bearer $DEALERCRM_KEY" -H "Content-Type: application/json" \
  -d '{ "vin": "1FTFW1E86PKE00000", "status": "sold" }'

{ "object":"inventory", "inventory_id": 139450, "vin": "1FTFW1E86PKE00000",
  "stock": "A1234", "sale_status_type": 5, "status": "sold",
  "previous_sale_status_type": 1 }

-H "Idempotency-Key: yourcrm-lead-000123"   # same key on every retry of this lead

curl -X POST https://dealercrm.com/partner/v1/webhooks \
  -H "Authorization: Bearer $DEALERCRM_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://your-app.com/hooks/dealercrm",
        "events": ["lead.created","customer.created","activity.logged"] }'

X-DealerCRM-Signature: t=1752083400,v1=<hex hmac-sha256>
X-DealerCRM-Event: lead.created
X-DealerCRM-Delivery: 8471

// Node.js
const crypto = require('crypto');
function verify(rawBody, sigHeader, secret) {
  const p = Object.fromEntries(sigHeader.split(',').map(kv => kv.split('=')));
  const expected = crypto.createHmac('sha256', secret)
    .update(p.t + '.' + rawBody).digest('hex');
  const ok = expected.length === p.v1.length &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(p.v1));
  if (!ok) throw new Error('bad signature');
  if (Math.abs(Date.now()/1000 - Number(p.t)) > 300) throw new Error('stale');
}

# Python
import hmac, hashlib, time
def verify(raw_body: bytes, sig_header: str, secret: str):
    p = dict(kv.split('=', 1) for kv in sig_header.split(','))
    expected = hmac.new(secret.encode(),
        p['t'].encode() + b'.' + raw_body, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(expected, p['v1']):
        raise ValueError('bad signature')
    if abs(time.time() - int(p['t'])) > 300:
        raise ValueError('stale')

{ "customer_id": 10000001,      // integer, stable id
  "first_name": "Jane", "last_name": "Doe", "full_name": "Jane Doe",
  "email": "jane@example.com",  // primary email
  "phone_mobile": "3105551234", "phone_home": null, "phone_work": null,
  "do_not_contact": false,
  "status_type": 1,
  "preferred_contact_channel": "sms",   // sms | email | call | null
  "point_person": { "id": 42, "name": "Alex Rivera" },  // assigned rep, or null
  "customer_since": "2025-03-01",
  "created": 1740787200 }         // unix seconds
// GET /customers/{id} adds: phones[], emails[], names[]

{ "inventory_id": 139450, "year": 2024, "make": "Ford", "model": "F-150",
  "trim": "XLT", "vin": "1FTFW1E86PKE00000", "stock_number": "A1234",
  "condition": "new", "mileage": 12,
  "ext_color": "Oxford White", "int_color": "Black",
  "msrp": 58230, "asking_price": 55990, "internet_price": 54990,
  "sale_status_type": 1,          // 1 = available, 5 = sold
  "primary_image_url": "https://…", "updated": "2026-07-09T16:15:49Z" }

{ "id": 48567841, "customer_id": 10000001, "activity_type": 2,
  "channel": "call", "direction": "1",   // "1" inbound, "2" outbound
  "created": 1752083400, "local_date": "2026-07-09",
  "body": "Connected • 3m 34s • from +13105551234\nRecording: https://…\n\n",
  "employee_name": "Alex Rivera", "lead_source": "partner_api",
  "vehicle": { "year": 2024, "make": "Ford", "model": "F-150", "vin": "…" },
  "is_olivia": false }

const KEY = process.env.DEALERCRM_KEY;
const BASE = 'https://dealercrm.com/partner/v1';

async function allInventory() {
  const out = [];
  let after = null;
  do {
    const url = new URL(BASE + '/inventory');
    url.searchParams.set('status', 'active');
    url.searchParams.set('limit', '100');
    if (after) url.searchParams.set('after', after);
    const res = await fetch(url, { headers: { Authorization: `Bearer ${KEY}` } });
    if (!res.ok) throw new Error('HTTP ' + res.status);
    const page = await res.json();
    out.push(...page.items);
    after = page.next_cursor;
  } while (after);
  return out;
}

import os, requests
KEY = os.environ["DEALERCRM_KEY"]
r = requests.post("https://dealercrm.com/partner/v1/leads",
    headers={"Authorization": f"Bearer {KEY}",
             "Idempotency-Key": "acme-lead-9931"},
    json={"customer": {"full": "Jane Doe", "email": "jane@example.com",
                       "phone": "310-555-1234"},
          "vehicle": {"year": 2024, "make": "Ford", "model": "F-150"},
          "source": "Acme Marketing"})
r.raise_for_status()
print(r.json())