Overview
Connect SimpliRoute with Flows360
Connect with SimpliRoute, the last-mile delivery optimization platform. Manage clients, vehicles, visits, routes, and optimize your delivery operations.
Use the SimpliRoute connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 35 actions and no declared triggers.
Available actions
- Get Account Details
- Get Clients
- Create Clients
- Bulk Delete Clients
- Create Client Custom Property
- Get Vehicles
- Create Vehicle
- Get Vehicle
- Plus 27 additional declared actions.
Available triggers
- No triggers are declared in this pinned package.
The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.
Technical guide
Technical reference
Package identity
- Connector: SimpliRoute
- Package:
@activepieces/piece-simpliroute@0.2.0 - Exact artifact digest:
sha256:03dc5ceb9724317655ff2a03f79f9543c5171f7fa819d5e60bc2e40656401970 - Runtime: Activepieces-compatible deterministic worker
- Source: the exact reviewed Activepieces source
Authentication
SECRET TEXT. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.
Action contracts
- Get Account Details (
get_me), Returns account information of the authenticated user via API token. Classification: read. - Get Clients (
get_clients), Retrieves the list of clients associated with the account. Can filter by client key. Classification: read. - Create Clients (
create_clients), Create one or multiple new clients in the account. Classification: read. - Bulk Delete Clients (
bulk_delete_clients), Delete multiple clients in a single call. Classification: read. - Create Client Custom Property (
create_client_property), Create a new custom attribute for clients. Classification: read. - Get Vehicles (
get_vehicles), Retrieve the list of vehicles registered in the account. Classification: read. - Create Vehicle (
create_vehicle), Register a new vehicle in the account. Classification: read. - Get Vehicle (
get_vehicle), Retrieve information of a specific vehicle. Classification: read. - Delete Vehicle (
delete_vehicle), Delete a vehicle by its ID. Classification: read. - Get Visits (
get_visits), Retrieve all registered visits. Can be filtered by planned visit date. Classification: read. - Create Visits (
create_visits), Create visits. Multiple visits can be created in a single request. Classification: read. - Get Visit (
get_visit), Retrieve details of a specific visit by ID. Classification: read. - Update Visit (Partial) (
update_visit_partial), Partially update fields of an existing visit. Classification: read. - Update Visit (Complete) (
update_visit), Completely update an existing visit with all fields. Classification: read. - Delete Visit (
delete_visit), Delete a visit by its ID. Classification: read. - Add Visit Items (
add_visit_items), Add items to an existing visit. Classification: read. - Get Routes (
get_routes), Retrieve the list of existing routes. Classification: read. - Create Route (
create_route), Create a new route manually by assigning vehicle, driver and date. Classification: read. - Get Route (
get_route), Retrieve details of a specific route. Classification: read. - Delete Route (
delete_route), Delete a route by its ID. Classification: read. - Get Plans (
get_plans), Retrieve the list of saved routing plans (executions). Classification: read. - Create an empty plan (
create_plan), Create an empty plan (execution) without routes (reserve a planning day). Classification: read. - Get vehicles with routes on date (
get_plan_vehicles), Returns the vehicles that have planned routes on the indicated date. Classification: read. - Get Visit Detail (
get_visit_detail), Get detailed information about a specific visit. Classification: read. - Get Drivers (
get_drivers), Retrieve the list of drivers registered in the account. Classification: read. - Create User (
create_users), Create new user/driver in the account. Classification: read. - Get User (
get_user), Retrieve information of a specific user by ID. Classification: read. - Update User (
update_user), Update information of an existing user. Classification: read. - Get Skills (
get_skills), Retrieve the list of skills available in the account. Classification: read. - Get Observations (
get_observations), Retrieve the list of observations available in the account. Classification: read. - Get Tags (
get_tags), Retrieve the list of tags available in the account. Classification: read. - Get Zones (
get_zones), Retrieve the list of zones available in the account. Classification: read. - Get Fleets (
get_fleets), Retrieve the list of fleets available in the account. Classification: read. - Get Sellers (
get_sellers), Retrieve the list of sellers available in the account. Classification: read. - Custom API Call (
custom_api_call), Make a custom API call to a specific endpoint Classification: read.
Trigger contracts
- No trigger delivery contracts are declared.
Verification
Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.
Capability summary
Authentication
Authentication method: custom
Authentication profiles
connection · custom
- API Key Required · protected credential
Supported objects
| Object | Read | Write | Notes |
|---|---|---|---|
| Get Account Details | Yes | No | Returns account information of the authenticated user via API token. |
| Get Clients | Yes | No | Retrieves the list of clients associated with the account. Can filter by client key. |
| Create Clients | Yes | No | Create one or multiple new clients in the account. |
| Bulk Delete Clients | Yes | No | Delete multiple clients in a single call. |
| Create Client Custom Property | Yes | No | Create a new custom attribute for clients. |
| Get Vehicles | Yes | No | Retrieve the list of vehicles registered in the account. |
| Create Vehicle | Yes | No | Register a new vehicle in the account. |
| Get Vehicle | Yes | No | Retrieve information of a specific vehicle. |
| Delete Vehicle | Yes | No | Delete a vehicle by its ID. |
| Get Visits | Yes | No | Retrieve all registered visits. Can be filtered by planned visit date. |
| Create Visits | Yes | No | Create visits. Multiple visits can be created in a single request. |
| Get Visit | Yes | No | Retrieve details of a specific visit by ID. |
| Update Visit (Partial) | Yes | No | Partially update fields of an existing visit. |
| Update Visit (Complete) | Yes | No | Completely update an existing visit with all fields. |
| Delete Visit | Yes | No | Delete a visit by its ID. |
| Add Visit Items | Yes | No | Add items to an existing visit. |
| Get Routes | Yes | No | Retrieve the list of existing routes. |
| Create Route | Yes | No | Create a new route manually by assigning vehicle, driver and date. |
| Get Route | Yes | No | Retrieve details of a specific route. |
| Delete Route | Yes | No | Delete a route by its ID. |
| Get Plans | Yes | No | Retrieve the list of saved routing plans (executions). |
| Create an empty plan | Yes | No | Create an empty plan (execution) without routes (reserve a planning day). |
| Get vehicles with routes on date | Yes | No | Returns the vehicles that have planned routes on the indicated date. |
| Get Visit Detail | Yes | No | Get detailed information about a specific visit. |
| Get Drivers | Yes | No | Retrieve the list of drivers registered in the account. |
| Create User | Yes | No | Create new user/driver in the account. |
| Get User | Yes | No | Retrieve information of a specific user by ID. |
| Update User | Yes | No | Update information of an existing user. |
| Get Skills | Yes | No | Retrieve the list of skills available in the account. |
| Get Observations | Yes | No | Retrieve the list of observations available in the account. |
| Get Tags | Yes | No | Retrieve the list of tags available in the account. |
| Get Zones | Yes | No | Retrieve the list of zones available in the account. |
| Get Fleets | Yes | No | Retrieve the list of fleets available in the account. |
| Get Sellers | Yes | No | Retrieve the list of sellers available in the account. |
| Custom API Call | Yes | No | Make a custom API call to a specific endpoint |
Supported actions
Get Account Details · Read
Returns account information of the authenticated user via API token.
get_me · Risk: low · Retry: safe
Get Clients · Read
Retrieves the list of clients associated with the account. Can filter by client key.
get_clients · Risk: low · Retry: safe
Inputs
key· string · Required, Unique client key to filter results.
Create Clients · Read
Create one or multiple new clients in the account.
create_clients · Risk: low · Retry: safe
Inputs
clients· array · Required, Array of client objects to create.
Bulk Delete Clients · Read
Delete multiple clients in a single call.
bulk_delete_clients · Risk: low · Retry: safe
Inputs
ids· array · Required, List of client IDs to delete.
Create Client Custom Property · Read
Create a new custom attribute for clients.
create_client_property · Risk: low · Retry: safe
Inputs
label· string · Required, Label of the new custom property.type· string · Required, Property type (str, int, float or bool).
Get Vehicles · Read
Retrieve the list of vehicles registered in the account.
get_vehicles · Risk: low · Retry: safe
Create Vehicle · Read
Register a new vehicle in the account.
create_vehicle · Risk: low · Retry: safe
Inputs
name· string · Required, The name of the vehicle.capacity· number · Required, The maximum capacity of the vehicle.default_driver· string · Optional, The assigned driver ID or null if not assigned.location_start_address· string · Required, The starting address of the vehicle.location_start_latitude· number · Required, The latitude of the starting location.location_start_longitude· number · Required, The longitude of the starting location.location_end_address· string · Required, The ending address of the vehicle.location_end_latitude· number · Required, The latitude of the ending location.location_end_longitude· number · Required, The longitude of the ending location.skills· object · Optional, a list of skill IDs (JSON format [1, 2]).capacity2· string · Optional, Secondary vehicle capacity.capacity3· string · Optional, Third vehicle capacity.cost· string · Optional, Operational cost of the vehicle.shift_start· string · Optional, Start time of the vehicle shift.shift_end· string · Optional, End time of the vehicle shift.reference_id· string · Optional, External reference ID of the vehicle.license_plate· string · Optional, License plate or registration of the vehicle.min_load· number · Optional, Minimum load (unit 1) required to dispatch.min_load_2· number · Optional, Minimum load (unit 2) required.min_load_3· number · Optional, Minimum load (unit 3) required.max_visit· number · Optional, Maximum number of visits that the vehicle can perform.max_time· number · Optional, Maximum duration of route (in seconds).rest_time_start· string · Optional, Start time of rest.rest_time_end· string · Optional, End time of rest.rest_time_duration· string · Optional, Duration of rest.
Get Vehicle · Read
Retrieve information of a specific vehicle.
get_vehicle · Risk: low · Retry: safe
Inputs
vehicle_id· number · Required, Vehicle ID.
Delete Vehicle · Read
Delete a vehicle by its ID.
delete_vehicle · Risk: low · Retry: safe
Inputs
vehicle_id· number · Required, Vehicle ID to delete.
Get Visits · Read
Retrieve all registered visits. Can be filtered by planned visit date.
get_visits · Risk: low · Retry: safe
Inputs
planned_date· string · Required, Filter visits by planned date (YYYY-MM-DD format).
Create Visits · Read
Create visits. Multiple visits can be created in a single request.
create_visits · Risk: low · Retry: safe
Inputs
visits· array · Required, Array of visit objects to create.
Get Visit · Read
Retrieve details of a specific visit by ID.
get_visit · Risk: low · Retry: safe
Inputs
visit_id· number · Required, Visit ID.
Update Visit (Partial) · Read
Partially update fields of an existing visit.
update_visit_partial · Risk: low · Retry: safe
Inputs
visit_id· number · Required, ID of the visit to update.title· string · Optional, Visit title (if you want to change it).address· string · Optional, Visit address (if you want to change it).load· number · Optional, Visit load (main unit).load_2· number · Optional, Visit load (unit 2).load_3· number · Optional, Visit load (unit 3).duration· string · Optional, Visit duration (HH:MM:SS).contact_name· string · Optional, Visit contact name.contact_phone· string · Optional, Visit contact phone.notes· string · Optional, Visit notes.planned_date· string · Optional, Visit planned date (YYYY-MM-DD).
Update Visit (Complete) · Read
Completely update an existing visit with all fields.
update_visit · Risk: low · Retry: safe
Inputs
visit_id· number · Required, ID of the visit to update.title· string · Required, Visit title.address· string · Required, Visit address.latitude· number · Optional, Visit latitude.longitude· number · Optional, Visit longitude.load· number · Optional, Visit load (main unit).load_2· number · Optional, Visit load (unit 2).load_3· number · Optional, Visit load (unit 3).duration· string · Optional, Visit duration (HH:MM:SS).contact_name· string · Optional, Visit contact name.contact_phone· string · Optional, Visit contact phone.notes· string · Optional, Visit notes.planned_date· string · Required, Visit planned date (YYYY-MM-DD).
Delete Visit · Read
Delete a visit by its ID.
delete_visit · Risk: low · Retry: safe
Inputs
visit_id· number · Required, ID of the visit to delete.
Add Visit Items · Read
Add items to an existing visit.
add_visit_items · Risk: low · Retry: safe
Inputs
visit_id· number · Required, ID of the visit to add items to.items· array · Required, Array of items to add to the visit.
Get Routes · Read
Retrieve the list of existing routes.
get_routes · Risk: low · Retry: safe
Inputs
planned_date· string · Required, Visit planned date (YYYY-MM-DD).
Create Route · Read
Create a new route manually by assigning vehicle, driver and date.
create_route · Risk: low · Retry: safe
Inputs
vehicle· number · Required, Vehicle ID for the route.driver· number · Required, Driver ID for the route.planned_date· string · Required, Planned route date (YYYY-MM-DD).estimated_time_start· string · Required, Estimated start time (HH:MM:SS).estimated_time_end· string · Required, Estimated end time (HH:MM:SS).location_start_address· string · Required, Route start address.location_start_latitude· string · Required, Route start latitude.location_start_longitude· string · Required, Route start longitude.location_end_address· string · Required, Route end address.location_end_latitude· string · Required, Route end latitude.location_end_longitude· string · Required, Route end longitude.plan· string · Required, Plan (execution) ID to associate the route (UUID).
Get Route · Read
Retrieve details of a specific route.
get_route · Risk: low · Retry: safe
Inputs
route_id· string · Required, Route ID (UUID).
Delete Route · Read
Delete a route by its ID.
delete_route · Risk: low · Retry: safe
Inputs
route_id· string · Required, Route ID to delete (UUID).
Get Plans · Read
Retrieve the list of saved routing plans (executions).
get_plans · Risk: low · Retry: safe
Inputs
date· string · Required, Planned date (YYYY-MM-DD).
Create an empty plan · Read
Create an empty plan (execution) without routes (reserve a planning day).
create_plan · Risk: low · Retry: safe
Inputs
name· string · Required, Plan name.start_date· string · Required, Start date (YYYY-MM-DD).end_date· string · Required, End date (YYYY-MM-DD).
Get vehicles with routes on date · Read
Returns the vehicles that have planned routes on the indicated date.
get_plan_vehicles · Risk: low · Retry: safe
Inputs
planned_date· string · Required, Planned date (YYYY-MM-DD).
Get Visit Detail · Read
Get detailed information about a specific visit.
get_visit_detail · Risk: low · Retry: safe
Inputs
visit_id· number · Required, ID of the visit to get details for.
Get Drivers · Read
Retrieve the list of drivers registered in the account.
get_drivers · Risk: low · Retry: safe
Create User · Read
Create new user/driver in the account.
create_users · Risk: low · Retry: safe
Inputs
username· string · Required, Nombre de usuario (login).name· string · Optional, Nombre completo del usuario.phone· string · Optional, Nu00famero de telu00e9fono.email· string · Optional, Correo electru00f3nico.is_admin· boolean · Optional, Whether the user is an administrator.password· string · Required, User password.is_driver· boolean · Required, Whether the user is a driver.is_router_jr· boolean · Optional, Whether the user is a router junior.is_router· boolean · Optional, Whether the user is a router.is_monitor· boolean · Optional, Whether the user is a monitor.is_coordinator· boolean · Optional, Whether the user is a coordinator.
Get User · Read
Retrieve information of a specific user by ID.
get_user · Risk: low · Retry: safe
Inputs
user_id· number · Required, User ID.
Update User · Read
Update information of an existing user.
update_user · Risk: low · Retry: safe
Inputs
user_id· number · Required, User ID to update.username· string · Required, Username (login).name· string · Required, Full name of the user.phone· string · Optional, User phone number.email· string · Optional, User email address.is_admin· boolean · Optional, Whether the user is an administrator.password· string · Optional, User password.is_driver· boolean · Optional, Whether the user is a driver.is_router_jr· boolean · Optional, Whether the user is a router junior.is_router· boolean · Optional, Whether the user is a router.is_monitor· boolean · Optional, Whether the user is a monitor.is_coordinator· boolean · Optional, Whether the user is a coordinator.
Get Skills · Read
Retrieve the list of skills available in the account.
get_skills · Risk: low · Retry: safe
Get Observations · Read
Retrieve the list of observations available in the account.
get_observations · Risk: low · Retry: safe
Get Tags · Read
Retrieve the list of tags available in the account.
get_tags · Risk: low · Retry: safe
Get Zones · Read
Retrieve the list of zones available in the account.
get_zones · Risk: low · Retry: safe
Get Fleets · Read
Retrieve the list of fleets available in the account.
get_fleets · Risk: low · Retry: safe
Get Sellers · Read
Retrieve the list of sellers available in the account.
get_sellers · Risk: low · Retry: safe
Custom API Call · Read
Make a custom API call to a specific endpoint
custom_api_call · Risk: low · Retry: safe
Inputs
url· object · Requiredmethod· string · Requiredheaders· object · Optional, Authorization headers are injected automatically from your connection.queryParams· object · Optional, Appended to the URL as ?key=value.body_type· string · Optionalbody· object · Optionalresponse_is_binary· boolean · Optional, Enable for files like PDFs, images, etc.failsafe· boolean · Optional, On a failed request, output the error instead of failing the step.timeout· number · Optional, Seconds to wait for a response. Empty: up to the flow limit (10 min).followRedirects· boolean · Optional, Follow 3xx redirects instead of returning them as the response.
Setup
Setup
- Add the SimpliRoute connector to the workflow in the target Flows360 Studio instance.
- Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
- Provide the connection fields declared by the pinned package:
- No provider credential fields are declared by the pinned package.
- Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
- Test the workflow in the appropriate environment before enabling production scheduling or event delivery.
Limitations
Limitations and operational notes
- This content describes
@activepieces/piece-simpliroute@0.2.0; provider behaviour can change independently and should be revalidated when the provider or connector version changes. - Only the 35 actions and 0 triggers declared by this pinned package are represented here.
- Tenant credentials and connection values are not stored in the public connector record.
- Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
- Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.
Troubleshooting
Why canu2019t the connector authenticate?
Check the tenant connection in Studio and confirm every required SimpliRoute connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.
Why is an action or trigger unavailable?
Confirm that the workflow is using @activepieces/piece-simpliroute@0.2.0 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.
What should I check after a provider-side change?
Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.