---
title: "OptimoRoute integration for LuumenAI"
url: "https://www.luumen.ai/integrations/optimoroute/"
entity: SoftwareIntegration
category: "Project management"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# OptimoRoute integration for LuumenAI

Read routes, orders, and driver activity. Replan the day as an approved step.

## What LuumenAI can do with OptimoRoute

LuumenAI connects to OptimoRoute with an API token and exposes 17 tools (8 read-only · 4 write · 5 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 17 tools (8 read-only · 4 write · 5 destructive)
- Plan: available on all plans
- Category: Project management

## About OptimoRoute with LuumenAI

Connect OptimoRoute and ask about the day as it stands: which routes are planned, which orders are still open, what drivers reported from the field, and where a delivery landed. Reads come back right away. Changes like creating orders, updating driver parameters, or starting a new optimization run are previewed and held for approval first.

## Example tools

Read-only (8 in total):

- `OPTIMOROUTE_GET_COMPLETION_DETAILS` — Retrieve completion details for one or more orders including proof of delivery data.
- `OPTIMOROUTE_GET_DRIVERS` — Retrieve all drivers in the system.
- `OPTIMOROUTE_GET_EVENTS` — Retrieve mobile events from drivers' field operations.
- `OPTIMOROUTE_GET_ORDERS` — Retrieve one or more orders from OptimoRoute.
- `OPTIMOROUTE_GET_PLANNING_STATUS` — Retrieve the status of an active planning/optimization process.
- `OPTIMOROUTE_GET_ROUTES` — Retrieve all planned routes for a given date.
- `OPTIMOROUTE_GET_SCHEDULING_INFO` — Retrieve scheduling information for a specific order.
- `OPTIMOROUTE_SEARCH_ORDERS` — Search for orders in OptimoRoute based on criteria.

Write and destructive (9 in total, approval required by default):

- `OPTIMOROUTE_CREATE_ORDER` — Create a new order or update an existing order in OptimoRoute.
- `OPTIMOROUTE_CREATE_OR_UPDATE_ORDERS` — Bulk create, update, or replace multiple orders at once without geocoding.
- `OPTIMOROUTE_DELETE_ALL_ORDERS` — Remove all orders and planned routes for a specified date.
- `OPTIMOROUTE_DELETE_ORDER` — Remove a single order from the OptimoRoute system.
- `OPTIMOROUTE_DELETE_ORDERS` — Delete one or more orders from the system in bulk (max 500 per request).
- `OPTIMOROUTE_START_PLANNING` — Start the planning/optimization process for a specified date or date range.
- `OPTIMOROUTE_STOP_PLANNING` — Stop an active planning/optimization process.
- `OPTIMOROUTE_UPDATE_DRIVER_PARAMETERS` — Update driver parameters for a specific date including work times, vehicle assignment, and start/end locations.

## Frequently asked questions

### How does LuumenAI connect to OptimoRoute?

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 OptimoRoute on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 5 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to OptimoRoute — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/optimoroute/