# OptimoRoute AI integration on Definable

> OptimoRoute is an online route optimization and planning solution for delivery, logistics, and field service companies.

## What this connects

OptimoRoute is an online route optimization and planning solution for delivery, logistics, and field service companies.

Vendor: https://optimoroute.com/

## Tools available

**17** tools available. First 12:

- `OPTIMOROUTE_CREATE_ORDER` — Create Order — Tool to create a new order or update an existing order in OptimoRoute. Use when you need to add delivery, pickup, or task orders to the system with location, time windows, and other constraints.
- `OPTIMOROUTE_CREATE_OR_UPDATE_ORDERS` — Create or Update Orders — Tool to bulk create, update, or replace multiple orders at once without geocoding. Use when you need to add new orders or modify existing ones efficiently. Supports up to 500 orders per request.
- `OPTIMOROUTE_DELETE_ALL_ORDERS` — Delete All Orders — Tool to remove all orders and planned routes for a specified date. Use when you need to clear orders for a specific date or delete all orders system-wide if no date is provided.
- `OPTIMOROUTE_DELETE_ORDER` — Delete Order — Tool to remove a single order from the OptimoRoute system. Use when you need to delete a specific order by its orderNo.
- `OPTIMOROUTE_DELETE_ORDERS` — Delete Orders — Tool to delete one or more orders from the system in bulk (max 500 per request). Use when you need to remove orders, either individually or in batch operations.
- `OPTIMOROUTE_GET_COMPLETION_DETAILS` — Get Order Completion Details — Tool to retrieve completion details for one or more orders including proof of delivery data. Use when you need to check order completion status, timing details, and form data.
- `OPTIMOROUTE_GET_DRIVERS` — Get Drivers — Tool to retrieve all drivers in the system. Use when you need up-to-date driver data including status and contact information.
- `OPTIMOROUTE_GET_EVENTS` — Get Mobile Events — Tool to retrieve mobile events from drivers' field operations. Use when you need to track order completions, status changes (success, failed, on_duty, off_duty), and other field events for the currently active plan.
- `OPTIMOROUTE_GET_ORDERS` — Get Orders — Tool to retrieve one or more orders from OptimoRoute. Use when you need detailed order information including location, time windows, and assignment details.
- `OPTIMOROUTE_GET_PLANNING_STATUS` — Get Planning Status — Tool to retrieve the status of an active planning/optimization process. Use when you need to check the progress of a planning job by providing its ID.
- `OPTIMOROUTE_GET_ROUTES` — Get Planned Routes — Tool to retrieve all planned routes for a given date. Use when you need a detailed view of routes including optional stops, route parameters, and unassigned orders.
- `OPTIMOROUTE_GET_SCHEDULING_INFO` — Get Order Scheduling Info — Tool to retrieve scheduling information for a specific order. Use when you need to check if an order is scheduled and get details like driver assignment, timing, and position.

## Auth

Auth schemes: `API_KEY`.

## How agents use OptimoRoute

Inside a Definable workflow, OptimoRoute is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → OptimoRoute** — the Researcher (GPT-5.5) pulls context from OptimoRoute (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → OptimoRoute** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into OptimoRoute (create record, post message, draft email).
- **Designer / Engineer → Distributor → OptimoRoute** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via OptimoRoute (attach file, open PR comment, post status).

The Verifier checks every OptimoRoute call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- project management — https://definable.ai/apps/category/project-management/

## Related

- HTML page: https://definable.ai/apps/optimoroute/
- Same category (project management): https://definable.ai/apps/category/project-management/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt