Step 1: Sync Entities

In this step, you must sync entities such as Users, Vehicles between Motive and your current system. This step is important as this will ensure a sync between both the systems. When you are syncing these entities, the most common issue that you will face is that of the nomenclature or naming of the data. You can then correct those issues and ensure both systems reflect the exact data for accurate integration of data between both the systems.

👍

SYNC

Motive supports bidirectional synchronization of all available entities on both platforms (users, vehicles, and assets). Begin your complete TMS integration by synchronizing all the entities.

1A: SYNC USERS

The first thing that you must do is to create a sync between Motive and your system with regards to your users. To do that, you must use the following endpoints:

LIST USERS: GET/https://api.gomotive.com/v1/users

Motive defines the following as users:

📘

NOTE

In this case, we only require the users with the role as "driver".

• Retrieve a list of all the users in Motive by using the above endpoint.
  The response fetches all the drivers associated with the company. You will have details like driver names, driver IDs, Contact Information and others.

---

1B: SYNC VEHICLES

As a next step, you must synchronize all the vehicles between Motive and your system. To do this, you must use the following endpoints:

LIST VEHICLES: GET/https://api.gomotive.com/v1/vehicles

• Retrieve a list of all the vehicles in Motive by using the above endpoint. The response fetches all the vehicles that are available in Motive as well as other details such as make, model, and VIN, license information, fuel type, and the driver with which the vehicle is currently associated with.