Skip to content
← Back to documentation
Technical Reference

SimpliRoute

Connect with SimpliRoute, the last-mile delivery optimization platform. Manage clients, vehicles, visits, routes, and optimize your delivery operations.

CategoryProductivity
Authenticationcustom
Version0.2.0
Published scopes0 published scopes
Last updatedSeptember 23, 2026

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

Authenticationcustom
Supported objects35
Supported actions35
TriggersNone published

Authentication

Authentication method: custom

Authentication profiles

connection · custom
  • API Key Required · protected credential

Supported objects

ObjectReadWriteNotes
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 · Required
  • method · string · Required
  • headers · object · Optional, Authorization headers are injected automatically from your connection.
  • queryParams · object · Optional, Appended to the URL as ?key=value.
  • body_type · string · Optional
  • body · object · Optional
  • response_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

  1. Add the SimpliRoute connector to the workflow in the target Flows360 Studio instance.
  2. 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.
  3. Provide the connection fields declared by the pinned package:
  • No provider credential fields are declared by the pinned package.
  1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
  2. 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.