API Reference
DealerAI Public API — manage inventory, conversations, contacts, promotions, and more.
The DealerAI API is a REST API that lets you integrate with the DealerAI platform programmatically.
All endpoints are under the /api/v1/ prefix and require Basic Authentication.
Authentication
Every request must include an Authorization header using HTTP Basic Authentication:
Authorization: Basic <base64(username:password)>Use the /api/v1/authentication/verify endpoint to validate credentials and retrieve your dealer_id.
Base URL
| Environment | Base URL |
|---|---|
| Production | https://engine.dealerai.com |
| Staging | https://engine-stg.dealerai.dev |
| Dev | https://engine-dev.dealerai.dev |
Endpoint Groups
Authentication
Verify credentials and retrieve dealer ID.
Inventory
Manage new and used vehicle inventory.
Conversations
Access conversation history and data.
Promotions
Create and manage dealership promotions.
Assistant Threads
Interact with the AI assistant threads.
AILM
Automate inbound lead management via contact, engage, and ADF outbound.
AI Connector (Claude & ChatGPT)
Connect Claude or ChatGPT to a DealerAI store so an AI assistant can look up inventory, read conversations, manage store information and start follow-up, using your existing portal account.
Add or Update Contact
Creates a new contact or updates an existing one based on email or phone. This operation does not send any messages to the contact.