Stops

Batch import stops

Batch import stops. The request body must contain an array of stops to import. If the plan is not writable, the request will fail, prefer using the Import Live Stops API instead.

post/plans/{planId}/stops:import

Request

Base URL
https://api.spoke.com/public/v1
Auth
HTTP basic
TypeScript
https://skmtc.dev/spoke/apis/spoke-api/docs/plans/:planId/stops:import/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

planIdstring required

The plan id

Request body

allowedDriversstring[] nullable

Driver IDs that are allowed to be assigned to this stop. These drivers must be configured as part of the plan to be valid.

activity'delivery' | 'pickup' nullable

Activity type

optimizationOrder'first' | 'last' | 'default' nullable

The preferred order of this stop in the optimized route. If not provided or "default", the stop will be placed in the optimal order, decided by the optimization algorithm. Otherwise it will be placed either "first" or "last".

packageCountnumber nullable

Number of packages in the stop

notesstring nullable

Notes for the stop

clientIdstring nullable

Client ID of the retailer in Spoke Connect

barcodesstring[]

List of barcode IDs associated with this stop

customPropertiesobject nullable

Key-value pairs of custom stop properties for this stop. The keys must be unique and match a custom stop property defined in your team.

Response

Success

successstring[] required

The ids of the successfully imported stops

Changes

No recorded changes to this operation across all 1 revision of this API.