Create New Lead (Open)

Authenticate with API key

Best Movers authenticates your API requests using your account’s secret API key

You can use the superadmin account in CRM Dashboard to reveal, revoke, and create secret API key

POST https://your-api-domain.bestmoverscrm.com/lead/import/ileadopen

All you need to create the new lead is just to send a post request to the API endpoint with the next params:

secretKey – required
name – customer fullname
phone – required if no email
email – required if no phone
typeOfMove – e.g., Local, Long Distance, etc.
source – lead source (Google, Yelp, Friends, etc.)
websiteSource – (optional) lead subsource
leadType – e.g., office
date – move date (YYYY-MM-DD)
note – any additional notes
fromAddress – full pickup address
fromAddressDoorman – true/false, is there a doorman?
fromAddressElevator – true/false, is there an elevator?
fromAddressCoi – true/false, COI required?
fromAddressStairs – true/false, stairs present?
fromAddressNote – pickup location notes
toAddress – full delivery address
toAddressDoorman – true/false, is there a doorman?
toAddressElevator – true/false, is there an elevator?
toAddressCoi – true/false, COI required?
toAddressStairs – true/false, stairs present?
toAddressNote – delivery location notes
additionalAddress1, additionalAddress2, ... – additional stop addresses (e.g. 789 Middle Rd, Midcity, MC 11111)
additionalAddressDoorman1, additionalAddressDoorman2, ... – true/false, is there a doorman at each stop
additionalAddressElevator1, additionalAddressElevator2, ... – true/false, elevator available
additionalAddressCoi1, additionalAddressCoi2, ... – true/false, COI required
additionalAddressStairs1, additionalAddressStairs2, ... – true/false, stairs present
additionalAddressNote1, additionalAddressNote2, ... – notes for each stop

Each additional address follows the same numbered pattern.
For example:

First stop: additionalAddress1, additionalAddressDoorman1, ...
Second stop: additionalAddress2, additionalAddressDoorman2, ...
Third stop: additionalAddress3, etc.

materials[] – list of materials used:
- name – name of the material (e.g. Box)
- price – numeric price
- quantity – integer quantity
itemsByRoom[] – categorized items by room:
- name – room name (e.g. Kitchen)
- items[] – list of items inside:
  - name – item name (e.g. Refrigerator)
  - quantity – item quantity

If everything good should obtain response: {"response":"success"}

Need some help?

We all do sometimes; code is not hard, but if you need help just email us

Send a simple request

$secretKey = 'your-secret-key';
$postData = [
    'email' => '[email protected]',
    'phone' => '1234567890',
    'name' => 'John Doe',
    'typeOfMove' => 'Local',
    'source' => 'Website',
    'websiteSource' => 'LandingPage',
    'leadType' => 'office',
    'date' => '2025-05-10',
    'note' => 'Customer prefers morning time',

    // From Address
    'fromAddress' => '123 Start St, Startville, ST 12345',
    'fromAddressDoorman' => 'true',
    'fromAddressElevator' => 'false',
    'fromAddressCoi' => 'true',
    'fromAddressStairs' => 'true',
    'fromAddressNote' => 'Use side entrance',

    // To Address
    'toAddress' => '456 End Ave, Endtown, EN 67890',
    'toAddressDoorman' => 'false',
    'toAddressElevator' => 'true',
    'toAddressCoi' => 'false',
    'toAddressStairs' => 'false',
    'toAddressNote' => 'Call before arrival',
];


// 🚚 Additional Stop Address
$additionalStops = [
    1 => [
        'address' => '789 Middle Rd, Midcity, MC 11111',
        'doorman' => 'true',
        'elevator' => 'false',
        'coi' => 'true',
        'stairs' => 'false',
        'note' => 'Ring apartment 3B',
    ],
    2 => [
        'address' => '1010 Second Stop Blvd, Stopville, ST 22222',
        'doorman' => 'false',
        'elevator' => 'true',
        'coi' => 'false',
        'stairs' => 'true',
        'note' => 'Use back entrance',
    ],
];

foreach ($additionalStops as $index => $stop) {
    $postData["additionalAddress".$index] = $stop['address'];
    $postData["additionalAddressDoorman".$index] = $stop['doorman'];
    $postData["additionalAddressElevator".$index] = $stop['elevator'];
    $postData["additionalAddressCoi".$index] = $stop['coi'];
    $postData["additionalAddressStairs".$index] = $stop['stairs'];
    $postData["additionalAddressNote".$index] = $stop['note'];
}

// 📦 
$materials = [
    ['name' => 'Box', 'price' => 12.5, 'quantity' => 5],
    ['name' => 'Tape', 'price' => 3.2, 'quantity' => 2],
];

// 🛋️ 
$itemsByRoom = [
    [
        'name' => 'Kitchen',
        'items' => [
            ['name' => 'Fridge', 'quantity' => 1],
            ['name' => 'Microwave', 'quantity' => 1],
        ],
    ],
    [
        'name' => 'Living Room',
        'items' => [
            ['name' => 'Sofa', 'quantity' => 1],
            ['name' => 'TV', 'quantity' => 1],
        ],
    ],
];

function flattenArray($array, $prefix = '')
{
    $result = [];
    foreach ($array as $key => $value) {
        $new_key = $prefix === '' ? $key : $prefix . "[$key]";
        if (is_array($value)) {
            $result += flattenArray($value, $new_key);
        } else {
            $result[$new_key] = $value;
        }
    }
    return $result;
}

$postData += flattenArray(['materials' => $materials]);
$postData += flattenArray(['itemsByRoom' => $itemsByRoom]);

$query = http_build_query($postData);

$contextData = [
    'method' => 'POST',
    'header' => "Content-Type: application/x-www-form-urlencoded\r\n" .
                "Content-Length: " . strlen($query) . "\r\n",
    'content' => $query,
];

$context = stream_context_create([
    'http' => $contextData,
    'ssl' => [
        'verify_peer' => false,
        'verify_peer_name' => false
    ]
]);

$url = 'https://your-api-domain.bestmoverscrm.com/lead/import/ileadopen?secretKey=' . urlencode($secretKey);
$result = file_get_contents($url, false, $context);

echo "Import response:\n" . print_r($result, true) . "";

Create New Lead (Open)

Authenticate with API key

Need some help?

Send a simple request

EXAMPLE JSON RESPONSE