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