Motive integration
Motive (formerly KeepTruckin) is a fleet management platform: ELD and Hours of Service compliance, vehicle and asset telematics, dashcams and driver safety. Read and manage users, vehicles, assets, groups, geofences, dispatches, documents, fuel purchases, timecards and webhooks; read HOS logs, violations and available time, vehicle and asset locations, fault codes, driver performance, speeding and scorecards, IFTA mileage, reefer telemetry, Motive Card transactions and freight-visibility tracking; request video recalls. Engine immobilizer control, live camera control and image capture, Motive Card locking and spend changes, CSV fuel imports and bulk AI document uploads are not exposed, and superseded API versions are left out. Authentication is a company API key created in the Motive Dashboard (Admin, Developers, Create an API Key), sent in the X-API-Key header.
Say what should happen.
The workflow builds itself.
What you can do with Motive
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Geofence, 5 operations
create_circular_geofenceCreate circular geofencePOSTCreates a circular geofence from a centre (centre_lat, centre_lon) and radius_in_meters; name and category are required.create_polygon_geofenceCreate polygon geofencePOSTCreates a polygon geofence from its location_points; name and category are required. Use create_circular_geofence for a circle.delete_geofenceDelete geofenceDELETEDeletes a geofence, identified by its id from list_geofences.get_geofenceGet geofenceGETReturns one geofence, identified by its id from list_geofences.list_geofencesList geofencesGETLists the company's geofences (named areas used to detect arrivals and departures), paginated; filter by name, category, status or update date.
User, 5 operations
create_userCreate userPOSTCreates a user (driver, fleet_user or admin) with name, email, username, password, role, phone country code and ELD mode (all required).find_userFind userGETFinds one user by email, username, driver_company_id or phone.get_userGet userGETReturns the complete details of one user, identified by its id from list_users.get_user_by_external_idGet user by external idGETFinds a user by the external id an integration assigned to it (external_id with its integration_name).list_usersList usersGETLists the users of the company (drivers, fleet users, admins), paginated; filter by role, duty status, status, name or update date.
Vehicle, 5 operations
create_vehicleCreate vehiclePOSTCreates a vehicle on the Motive Fleet Dashboard; number (unique within the company) is required.find_vehicle_by_numberFind vehicle by numberGETFinds a vehicle by the number assigned to it in Motive.get_vehicleGet vehicleGETReturns the details of one vehicle, identified by its id from list_vehicles.get_vehicle_by_external_idGet vehicle by external idGETFinds a vehicle by the external id a third-party integration assigned to it (external_id with its integration_name).list_vehiclesList vehiclesGETLists the company's vehicles, paginated; filter by driver, fuel type or update date.
Document, 4 operations
create_documentCreate documentPOSTCreates a document for a user from a document form (document_form_id), with its date, reference number, notes, form fields and attachments.delete_documentDelete documentDELETEDeletes a document, identified by its id from list_documents.get_documentGet documentGETReturns one document, identified by its id from list_documents.list_documentsList documentsGETLists driver documents within a time range, paginated; filter by ids, form, category, uploader, status or creation and update dates.
Fuel purchase, 4 operations
create_fuel_purchaseCreate fuel purchasePOSTRecords a fuel purchase: vehicle_id, driver_id, purchased_at, jurisdiction, fuel_type, fuel and fuel_unit are required.delete_fuel_purchaseDelete fuel purchaseDELETEDeletes a fuel purchase record, identified by its id from list_fuel_purchases.get_fuel_purchaseGet fuel purchaseGETReturns one fuel purchase, identified by its id from list_fuel_purchases.list_fuel_purchasesList fuel purchasesGETLists the fuel purchases recorded by your drivers and fleet admins, paginated; filter by date range, fuel type, vehicle, jurisdiction or source.
Group, 4 operations
create_groupCreate groupPOSTCreates a group with a name, optionally under a parent group (parent_id).delete_groupDelete groupDELETEDeletes a group, identified by its id from list_groups.get_groupGet groupGETReturns one group, identified by its id from list_groups.list_groupsList groupsGETLists the groups of the organisation (used to organise users, vehicles, assets and geofences), paginated.
Asset, 3 operations
create_assetCreate assetPOSTCreates an asset (a piece of equipment used with a vehicle, such as a reefer or a trailer). name, type, make, model and year are required.get_asset_by_external_idGet asset by external idGETFinds an asset by the external id an integration assigned to it (external_id with its integration_name).list_assetsList assetsGETLists the company's assets (trailers, reefers and other equipment used with vehicles), paginated; filter by name or status.
Asset location, 3 operations
get_asset_location_historyGet asset location historyGETReturns an asset's location details and breadcrumbs between start_date and end_date (both required), paginated with a cursor.list_asset_locationsList asset locationsGETLists the company's assets (trailers and other equipment) with their current location, paginated; filter by asset name.locate_assetLocate assetPUTRequests the latest location of an asset equipped with an Asset Gateway Mini (Locate My Asset) and returns the locate status with the last known location.
Dispatch location, 3 operations
create_dispatch_locationCreate dispatch locationPOSTCreates a dispatch location: geocoded (lat, lon, arrive_radius, depart_radius) or defined by its address only.delete_dispatch_locationDelete dispatch locationDELETEDeletes a dispatch location, identified by its id (query parameter) from list_dispatch_locations.list_dispatch_locationsList dispatch locationsGETLists the company's dispatch locations (geocoded with coordinates and radius, or address only), paginated; filter by ids or vendor ids.
Duty event, 3 operations
create_duty_eventCreate duty eventPOSTCreates a driver's ON_DUTY or OFF_DUTY event with its time, notes and location.delete_duty_eventDelete duty eventDELETEDeletes a driver's duty event, identified by its id from list_duty_events.list_duty_eventsList duty eventsGETLists drivers' duty events (such as ON_DUTY and OFF_DUTY), paginated; filter by driver_ids or date range.
Webhook, 3 operations
create_webhookCreate webhookPOSTCreates a company webhook: Motive posts the chosen actions (events such as vehicle_location_updated) to your url, in the chosen format.get_webhookGet webhookGETReturns one company webhook, identified by its id from list_webhooks.list_webhooksList webhooksGETLists the company's webhooks (callback URL, format, subscribed actions, enabled flag), paginated.
Compliance driving event, 2 operations
get_compliance_driving_eventGet compliance driving eventGETReturns one compliance driving event by its id from list_compliance_driving_events.list_compliance_driving_eventsList compliance driving eventsGETLists compliance driving events for the company, paginated; filter by driver, vehicle, status, type, annotation status or date range.
Dispatch, 2 operations
create_dispatchCreate dispatchPOSTCreates a dispatch with its stops (dispatch_stops) and trips (dispatch_trips), each identified by your own vendor_id.list_dispatchesList dispatchesGETLists the company's dispatch records (trips and stops), paginated; filter by ids, vendor ids, driver, vehicle, status or update time.
Driving period, 2 operations
assign_driving_period_driverAssign driving period driverPUTAssigns a driver to an unidentified driving period (UDE or DPE), identified by driving_period_id from list_driving_periods; driver_id is required, notes optional.list_driving_periodsList driving periodsGETLists the driving periods of the company's vehicles, paginated; filter by driver, vehicle, type, status, annotation status, assignment or date range.
External id, 2 operations
create_external_idCreate external idPOSTAttaches an external integration id to a Motive entity (a user, vehicle or other holder), so it can be looked up by that id later.delete_external_idDelete external idDELETEDeletes an external integration id attached to an entity, identified by its id.
Group asset, 2 operations
add_group_assetsAdd group assetsPOSTAdds assets to a group: pass the asset ids in ids.list_group_assetsList group assetsGETLists the assets of a group, paginated.
Group geofence, 2 operations
add_group_geofencesAdd group geofencesPOSTAdds geofences to a group: pass the geofence ids in ids.list_group_geofencesList group geofencesGETLists the geofences associated with a group, paginated.
Group user, 2 operations
add_group_usersAdd group usersPOSTAdds one or more users (drivers) to a group: pass the user ids in ids.list_group_usersList group usersGETLists the users of a group.
Group vehicle, 2 operations
add_group_vehiclesAdd group vehiclesPOSTAdds vehicles to a group: pass the vehicle ids in ids.list_group_vehiclesList group vehiclesGETLists the vehicles of a group.
Inspection report, 2 operations
get_inspection_report_by_external_idGet inspection report by external idGETFinds an inspection report by the external id an integration assigned to it (external_id with its integration_name).list_inspection_reportsList inspection reportsGETLists the company's vehicle and asset inspection reports, paginated; filter by driver, vehicle, asset, status, entity type or date range.
Log suggestion, 2 operations
create_log_suggestionCreate log suggestionPOSTCreates a log suggestion (a proposed correction to a driver's log) for log_id, relayed by dispatcher_id; both required.list_log_suggestionsList log suggestionsGETLists log suggestions (proposed corrections to drivers' duty-status logs), paginated.
Message, 2 operations
list_messagesList messagesGETLists the messages you have sent to your drivers, paginated; filter by update time. Set the X-User-Id header to the sending user's id.list_sent_messagesList sent messagesGETLists the messages sent by one user (sender_id, required), paginated; filter by send time or receivers.
Motive card, 2 operations
get_motive_cardGet motive cardGETReturns the details of one Motive Card, identified by card_id from list_motive_cards.list_motive_cardsList motive cardsGETLists the Motive Cards (fleet fuel and expense cards) of your company, paginated; filter by last four digits, status, driver, vehicle, group or spend profile.
Spend profile, 2 operations
get_spend_profileGet spend profileGETReturns one spend profile, identified by spend_profile_id from list_spend_profiles.list_spend_profilesList spend profilesGETLists the spend profiles (spending rules applied to Motive Cards) of your company, paginated.
Subscribed vehicle location, 2 operations
get_subscribed_vehicle_location_historyGet subscribed vehicle location historyGETFreight visibility: returns the recent location details of one subscribed vehicle, at most the past 24 hours; identify it by vehicle_id, vehicle_name or driver_id.list_subscribed_vehicle_locationsList subscribed vehicle locationsGETFreight visibility: lists the current locations of all the vehicles you have subscribed to.
Timecard entry, 2 operations
create_timecard_entriesCreate timecard entriesPOSTCreates timecard entries for one user on one date (date and user_id required).list_timecard_entriesList timecard entriesGETLists timecard entries per day per driver, paginated; filter by user_ids or date range.
Tracking subscription, 2 operations
cancel_location_trackingCancel location trackingDELETEFreight visibility: cancels a location-tracking subscription, identified by the tracking_subscription_id from subscribe_location_tracking.list_vehicle_tracking_subscriptionsList vehicle tracking subscriptionsGETFreight visibility: lists your active vehicle tracking subscriptions; filter by carrier (company_id or dot_id) or vehicle.
Vehicle location, 2 operations
get_vehicle_location_historyGet vehicle location historyGETReturns a vehicle's location records between start_date and end_date (required), for the vehicle id from list_vehicles.list_vehicle_locationsList vehicle locationsGETLists the company's vehicles with their current location, assigned driver and fuel type, paginated; filter by vehicle_ids or vehicle_status.
Video recall request, 2 operations
create_video_recall_requestCreate video recall requestPOSTRequests dashcam or Omnicam footage of a vehicle or asset from start_time for duration seconds; subject to rate limits and the monthly quota (get_video_recall_quota). Follow it with get_video_recall_request.get_video_recall_requestGet video recall requestGETReturns one video recall request with its status, identified by the id from create_video_recall_request.
Video timeline, 2 operations
list_asset_video_timelinesList asset video timelinesGETReturns the available video timeline segments of an asset (asset_name), to check footage exists before create_video_recall_request.list_vehicle_video_timelinesList vehicle video timelinesGETReturns the available video timeline segments of a vehicle (vehicle_number), to check footage exists before create_video_recall_request.
Waste pickup event, 2 operations
get_waste_pickup_eventGet waste pickup eventGETReturns the full detail of one published waste pickup event, identified by the offline_id from list_waste_pickup_events.list_waste_pickup_eventsList waste pickup eventsGETLists published waste pickup events (AI Vision) between start_time and end_time (RFC3339, required), paginated; filter by driver, vehicle, severity, overage or contamination. Get one event's detail with get_waste_pickup_event.
Asset geofence event, 1 operation
list_asset_geofence_eventsList asset geofence eventsGETLists geofence entry and exit events of the company's assets, paginated; filter by date range, geofence or asset.
Camera connection event, 1 operation
list_camera_connection_eventsList camera connection eventsGETLists dashcam connection and disconnection events, paginated; filter by vehicle, driver, date range, type or status.
Carrier asset, 1 operation
list_nearby_carrier_assetsList nearby carrier assetsGETFreight visibility: lists a carrier's assets sorted by proximity to a location (lat and lon); identify the carrier by company_id or dot_id.
Carrier consent, 1 operation
check_carrier_consentCheck carrier consentGETFreight visibility: checks whether your company is associated with a carrier (company_id or dot_id) and has the permissions to fetch its data.
Carrier vehicle, 1 operation
list_nearby_carrier_vehiclesList nearby carrier vehiclesGETFreight visibility: lists a carrier's vehicles near a location (lat and lon), with their details and current location; identify the carrier by company_id or dot_id.
Company, 1 operation
get_companyGet companyGETIdentifies the company the credential belongs to and returns its details: name, address, DOT ids, HOS cycle, time zone, HOS exceptions and subscription plan.
Dispatch stop form, 1 operation
list_dispatch_stop_formsList dispatch stop formsGETLists the dispatch stop forms (records drivers fill in at the stops of a dispatch route), paginated.
Document form, 1 operation
list_document_formsList document formsGETLists the document forms of your company with the given status (required), paginated.
Driver available time, 1 operation
list_driver_available_timeList driver available timeGETLists drivers with their available Hours of Service time, paginated; filter by driver_ids.
Driver location, 1 operation
list_driver_locationsList driver locationsGETLists the company's drivers with their current location and the vehicle they are using, paginated; filter by driver_ids.
Driver performance event, 1 operation
list_driver_performance_eventsList driver performance eventsGETLists driver performance events (hard braking, rapid acceleration, speeding and similar), paginated; filter by driver, vehicle, event type, behavior tags or date range.
Driver scorecard, 1 operation
list_driver_scorecardsList driver scorecardsGETLists driver safety scorecard summaries (score, hard brakes, hard accelerations, coached events), paginated; filter by driver_ids or date range.
Eld device, 1 operation
list_eld_devicesList eld devicesGETLists the vehicle gateways (ELD devices) assigned to the company, paginated; filter by identifiers, vehicle or update date.
Eld disconnect, 1 operation
list_eld_disconnectsList eld disconnectsGETLists vehicle gateway disconnect events, paginated; filter by vehicle, date range or status.
Engine immobilizer, 1 operation
get_engine_immobilizer_statusGet engine immobilizer statusGETReturns the read-only status of a vehicle's engine immobilizer, for the vehicle_id from list_vehicles.
Fault code, 1 operation
list_fault_codesList fault codesGETLists vehicle engine fault codes, paginated; filter by ELD device, vehicle, status, type or date range.
Form entry, 1 operation
list_form_entriesList form entriesGETLists the form entries drivers submitted (dispatch, vehicle and compliance forms), paginated; filter by dispatch, driver, vehicle or creation time.
Geofence event, 1 operation
list_geofence_eventsList geofence eventsGETLists geofence entry and exit events of vehicles and drivers, paginated; filter by date range, geofence, driver or vehicle.
Hos log, 1 operation
list_hos_logsList hos logsGETLists drivers' Hours of Service (HOS) daily logs, paginated; filter by driver, date range, status or update date.
Hos violation, 1 operation
list_hos_violationsList hos violationsGETLists drivers' Hours of Service (HOS) violations, paginated; filter by driver, start-time window or violation types.
Hours of service, 1 operation
list_hours_of_serviceList hours of serviceGETLists the company's drivers with their Hours of Service (HOS) data, paginated; filter by driver_ids or date range.
Ifta summary, 1 operation
get_ifta_mileage_summaryGet ifta mileage summaryGETReturns the IFTA mileage summary of the company's vehicles per jurisdiction, paginated; filter by jurisdiction, vehicle, date range or fuel type.
Ifta trip, 1 operation
list_ifta_tripsList ifta tripsGETLists the company vehicles' IFTA trip reports (distance per jurisdiction), paginated; filter by jurisdiction, vehicle, date range or fuel type.
Motive card transaction, 1 operation
list_motive_card_transactionsList motive card transactionsGETLists Motive Card transactions across your fleet, paginated, to audit spend and reconcile charges; filter by driver, vehicle, card, date range or transaction status.
Oem entity, 1 operation
list_oem_entitiesList oem entitiesGETLists the company's OEM entities (assets or machinery connected through an OEM integration); filter by time range or equipment_id.
Out of service reason, 1 operation
list_out_of_service_reasonsList out of service reasonsGETLists the configured reasons a vehicle can be marked Out of Service (OOS).
Reefer activity, 1 operation
list_reefer_activityList reefer activityGETReturns the most recent reefer activity for one or many assets, combining asset and location details with OEM and sensor telemetry; filter by asset, state or update date.
Reefer activity report, 1 operation
get_reefer_activity_reportGet reefer activity reportGETReturns the activity report of one reefer: reefer_id, start_time and end_time (Unix) and frequency (minutes between samples) are required.
Reefer sensor sample, 1 operation
list_reefer_sensor_samplesList reefer sensor samplesPOSTReturns the sensor samples of one or more reefer assets from start_time (epoch seconds, required) to end_time.
Reefer threshold, 1 operation
get_reefer_thresholdsGet reefer thresholdsGETReturns the company-level reefer temperature thresholds the webhooks use to decide when to emit temperature-breach events.
Speeding event, 1 operation
list_speeding_eventsList speeding eventsGETLists the speeding events of the company's drivers (speed over the posted limit, duration, location); filter by driver, vehicle or date range.
Subscribed asset location, 1 operation
list_subscribed_asset_locationsList subscribed asset locationsGETFreight visibility: lists the locations of all the assets you have subscribed to with subscribe_location_tracking.
Tracking company, 1 operation
list_tracking_companiesList tracking companiesGETFreight visibility: lists the carrier companies that allow you to track their vehicles.
User role, 1 operation
list_user_rolesList user rolesGETLists the user roles (such as admin, fleet manager or driver) and their permissions, paginated.
Vehicle utilization, 1 operation
list_vehicle_utilizationList vehicle utilizationGETReturns the utilization summary of vehicles (utilization percentage, idle and driving time and fuel, distance), paginated; filter by vehicle_ids or time range.
Video recall quota, 1 operation
get_video_recall_quotaGet video recall quotaGETReturns the company's video recall quota and rate limit.
Webhook request, 1 operation
list_webhook_requestsList webhook requestsGETLists the webhook deliveries Motive made to your company's webhooks, with response code and failure count, paginated; filter by webhook, action, response code or date.
Worked time, 1 operation
list_worked_timeList worked timeGETReturns the total seconds worked per day per driver for the user_ids given (required), paginated; filter by date range.
Showing the first 120 of 146 endpoints. The rest are in the product, searchable from the workflow builder and from chat.
Use Motive from Claude Code, Cursor or Codex
Connect Motive in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Motive operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Motive
- Create your workspace
Sign up free. Nothing to install.
- Connect Motive once
Add your Motive connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Motive integration FAQ
What can you do with the Motive integration?
LiveContext exposes 146 operations on Motive, covering geofence, user, vehicle and document.
