Route4me
for LuumenAI
Read routes and address books, then create optimizations as approved steps
Connect Route4Me and Luumen can read your address book, geocode stops, pull route destinations, and check avoidance zones without leaving the terminal. When a change is needed — a new optimization, an added address, a route note — Luumen shows the plan first and asks before it writes. Authentication is by API key.
The Route4me toolbox
96 tools: 50 read, 46 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadDisplay Datatable ConfigRetrieve datatable configuration for vehicle capacity profiles.
- ReadFind AddressRetrieve detailed information about a specific address from the Route4Me address book.
- ReadGeocode AddressGeocode an address and obtain its coordinates.
- ReadGeocode Address (Body)Geocode an address by sending a body payload with the address and options.
- ReadBulk Geocode AddressesGeocode multiple addresses in a single request.
- ReadGeocode Address ForwardConvert an address to geographic coordinates using forward geocoding.
- ReadGet Activity FeedRetrieve activities from the Route4Me activity feed with optional filtering and pagination.
- ReadGet AddressGet address/destination information from a route.
- ReadGet Address Book GroupsRetrieve address book groups from Route4Me.
- ReadGet Addresses from Address BookRetrieve addresses from the Route4Me address book.
- ReadGet Async Export Tracking HistorySave tracking history file via async export.
- ReadGet All Territories (Avoidance Zones v5)Retrieve all avoidance zones (territories) using API v5.0.
- ReadGet Avoidance Zone By IDRetrieve a specific avoidance zone by its territory ID.
- ReadGet Clustered LocationsRetrieve locations grouped by geographic proximity using geohash clustering.
- ReadGet Current Member InformationRetrieve the current authenticated member's information.
- ReadGet Last Scheduled Route for MemberRetrieve the most recently scheduled route for a specific member as of today.
- ReadGet Location HeatmapRetrieve a heat map of location clusters from the address book.
- ReadGet Location Service-Time HeatmapRetrieve location service-time heatmap data for address book locations.
- ReadGet Location TypeGet location type details by ID.
- ReadGet Member Configuration SettingsGet member configuration settings with optional filtering.
- ReadGet Note Custom TypesRetrieve all custom note types configured for the account.
- ReadGet Optimization ProfileRetrieve detailed information about an optimization profile by its unique identifier.
- ReadGet Route Destination By IDGet a route address/destination by its ID.
- ReadGet Route InfoGet detailed route information by route ID.
- ReadGet Route ListRetrieve a list of routes with filtering and pagination.
- ReadGet Route SettingsGet route settings with detailed information including waypoints, optimization settings, and delivery details.
- ReadGet Territories with Location CountsRetrieve territories with location counts for geographic analysis.
- ReadGet TerritoryRetrieve territory information by ID or get all territories.
- ReadGet Tracking History ExportExport tracking history file from Route4Me.
- ReadGet User By IDRetrieve a sub-user by their unique ID.
- ReadGet User LocationsView locations of all users/drivers in real-time.
- ReadGet User Modification HistoryGet user modification history from Route4Me.
- ReadGet User TemplateRetrieve the template of a sub-user with detailed information including contact information, preferences, and account status.
- ReadGet User Information (v4)Retrieve authenticated user information in v4 format.
- ReadGet VehiclesRetrieve details of vehicles in the organization.
- ReadGet Vehicle Capacity Profile As DatatableRetrieve vehicle capacity profiles in datatable format with pagination.
- ReadGet Vehicle Capacity Profile by IDRetrieve a specific vehicle capacity profile by its ID.
- ReadGet Vehicle Capacity Profile Page ConfigRetrieve vehicle capacity profile page configuration including unit settings.
- ReadGet Vehicle Capacity ProfilesRetrieve vehicle capacity profiles with weight, volume, and item constraints.
- ReadList Location TypesRetrieve location type definitions used in the address book system.
- ReadList Optimization ProfilesRetrieve optimization profiles with settings and configuration details.
- ReadList OptimizationsGet a list of all optimizations or retrieve a single optimization by ID.
- ReadList Order Custom FieldsRetrieve all order custom field definitions from Route4Me v5.0 API.
- ReadList Route DirectionsGet detailed route directions including turn-by-turn navigation information for each stop.
- ReadList Team UsersGet the list of team members/users in the account.
- ReadList Users By IDsRetrieve detailed information about team members by their member IDs.
- ReadList Team Users (Paginated)Get a paginated list of team members/users in the account.
- ReadLookup For New DestinationLookup optimal routes for inserting a new destination.
- ReadPreview Route AssignmentGenerate a preview of route assignments based on filters, grouping, sorting, and assignment strategy without applying changes.
- ReadReverse Geocode AddressReverse geocode coordinates to obtain an address.
- WriteAdd Order Custom FieldAdd a new custom field definition for orders. Approval by default
- WriteAdd Route NoteAdd a note to a route or address destination. Approval by default
- WriteCreate AddressAdd a new address to the address book. Approval by default
- WriteCreate Avoidance ZoneCreate an avoidance zone with circular, rectangular, or polygon shape. Approval by default
- WriteCreate Location TypeCreate a new location type in the address book. Approval by default
- WriteCreate Master RouteCreate a new master route in Route4Me. Approval by default
- WriteCreate Custom Note TypeCreate a new custom note type in Route4me. Approval by default
- WriteCreate Route OptimizationCreate a new route optimization in Route4Me. Approval by default
- WriteCreate Optimization ProfileCreate a new optimization profile in Route4Me. Approval by default
- WriteCreate Order Custom FieldCreate a new custom field definition for orders. Approval by default
- WriteCreate Orders from ContactsCreate orders from address book contacts. Approval by default
- WriteCreate TerritoryCreate a new territory with circular, rectangular, or polygon shape. Approval by default
- WriteCreate Vehicle Capacity ProfileCreate a vehicle capacity profile with weight, volume, item count, and revenue limits. Approval by default
- WriteDelete Address from RouteDelete an address from a route. Approval by default
- WriteDelete AddressesDelete addresses from the Route4Me address book. Approval by default
- WriteDelete Avoidance ZoneDelete an avoidance zone by territory_id. Approval by default
- WriteDelete Configuration SettingDelete a member configuration setting by config_key. Approval by default
- WriteDelete Current UserDelete the current authenticated user account. Approval by default
- WriteDelete Location TypeDelete a location type from the address book. Approval by default
- WriteDelete OptimizationRemove optimization problems from the Route4Me database. Approval by default
- WriteDelete Optimization ProfileDelete an optimization profile by ID. Approval by default
- WriteDelete Order Custom FieldDelete an order custom field by ID. Approval by default
- WriteDelete Route V4Delete one or more routes by route_id. Approval by default
- WriteDelete TerritoryDelete a territory by territory_id. Approval by default
- WriteDelete Vehicle Capacity Profile by IDDelete a vehicle capacity profile by ID. Approval by default
- WriteDispatch RoutesApprove or revoke routes for execution in Route4Me. Approval by default
- WriteDuplicate RoutesDuplicate one or more existing routes. Approval by default
- WriteSubmit Device Tracking DataSubmit device GPS tracking information to Route4Me. Approval by default
- WriteMerge RoutesMerge multiple routes into a single target route. Approval by default
- WriteMove Route DestinationMove a destination from one route to another. Approval by default
- WriteRe-run OptimizationRe-optimize an existing optimization problem by updating route parameters and/or addresses. Approval by default
- WriteSet Destination StatusSet or update the status of a route destination. Approval by default
- WriteSet Route RatingSet a rating for a route. Approval by default
- WriteSet Route Tracking DataInsert tracking data for a route. Approval by default
- WriteUpdate AddressUpdate an existing address in the Route4Me address book. Approval by default
- WriteUpdate Avoidance ZoneUpdate an existing avoidance zone. Approval by default
- WriteUpdate Location TypeUpdate an existing location type in the address book. Approval by default
- WriteUpdate Member Configuration SettingUpdate a member configuration setting. Approval by default
- WriteUpdate Custom Note TypeUpdate an existing custom note type in Route4Me. Approval by default
- WriteUpdate Optimization ProfileUpdate an existing optimization profile. Approval by default
- WriteUpdate Order Custom FieldUpdate an existing order custom field in Route4Me. Approval by default
- WriteUpdate RoutesBulk update multiple routes in a single operation. Approval by default
- WriteUpdate Route SettingsUpdate route settings including optimization parameters, distance units, and device types. Approval by default
- WriteUpdate Route V4Update route parameters and addresses in Route4Me. Approval by default
- WriteUpdate TerritoryUpdate an existing territory. Approval by default
- WriteUpdate Vehicle Capacity Profile By IDUpdate an existing vehicle capacity profile by ID. Approval by default
One prompt, start to finish
What a governed Route4me run looks like inside Luumen.
Questions
How does LuumenAI connect to Route4me?
Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in Route4me on its own?
Read actions answer immediately. Anything that writes — add order custom field, add route note, create address, create avoidance zone, and more — is shown as a plan and requires approval by default, including the 12 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
Who gets access to the integration?
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Is there an audit trail?
Every call to Route4me — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Put Route4me to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.