Add New Dealer

The Motovizion AI API allows you to insert new dealers to automatically go live based on the subscription start date.

Endpoint

https://api-v2.motovizion.ai/dealer/

Request Format

HTTP Method

POST

Content-Type

application/json

Request Body

The request body should be a JSON object with the following fields:

Parameter	Type	Required	Description
dealer_uuid	String	True	The unique ID of the new dealer
dealer_name	String	True	Common Name for dealer
dept_uuid	String	True	Department UUID
user_uuid	String	True	User UUID for sending SMS messages
timezone	String	True	Local timezone of dealer
dealer_location	String	False	City, State
dealer_number	String	True	Phone number of dealer
dealer_address	String	True	Dealer physical address
franchise	String	False	Dealers OEM brand, Ok to pass multiple
dealer_logo	String	True	URL of dealer logo
start_date	String	True	mm/dd/YY
dealer_notes	String	False	Any extra notes
exclusion_list	String	False	Opcode exclusion list, comma separated

Timezone Options

America/New_York
America/Chicago
America/Denver
America/Los_Angeles

Opcode Exclusion List (Comma Separated String)

opcode1, opcode2, opcode3

Making an Authorized POST Request

Make sure to include trailing backslash in POST URL after dealer/

curl -X POST https://api-v2.motovizion.ai/dealer/ \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY_HERE" \
-d '{
    "dealer_uuid": "DEALER12345",
    "dealer_name": "Premier Example Motors",
    "dept_uuid": "SVCDEPT01",
    "user_uuid": "USERXYZ789",
    "timezone": "America/New_York",
    "dealer_location": "New York, NY",
    "dealer_number": "[phone]",
    "dealer_address": "1 Auto Drive, New York, NY 10001",
    "franchise": "Toyota",
    "dealer_logo": "https://example.com/logos/dealer12345.png",
    "start_date": "05/02/2025",
    "dealer_notes": "New dealer setup.",
    "exclusion_list": "OILCHANGE,TIRE_ROTATION"
}'

Responses

Status Code: 201 Created

{
    "status": "success",
    "response": "Dealer added successfully",
    "dealer_uuid": "DEALER12345"
}

Status Code: 400 Bad Request

{
    "status": "error",
    "response": "Invalid JSON format: Syntax error"
}

Status Code: 400 Bad Request

{
    "status": "error",
    "response": "Invalid JSON payload structure."
}

Status Code: 400 Bad Request

{
    "status": "error",
    "response": "Missing required fields: dealer_name, timezone"
}

Status Code: 401 Unauthorized

{
    "status": "error",
    "response": "Invalid API Key"
}

Status Code: 405 Method Not Allowed

{
    "status": "error",
    "response": "Invalid request method. Only POST is accepted."
}

Status Code: 500 Internal Server Error

{
    "status": "error",
    "response": "Server configuration error: API key not set."
}

Status Code: 500 Internal Server Error

{
    "status": "error",
    "response": "Failed to add dealer. Please contact support."
}