SPspoke
Live Stops

Create a new stop

Create a new stop with the given data on live plans. When the plan is not writable, this endpoint starts an editing session and the action can be applied through a new optimization, or be discarded. Prefer using the batch import endpoint if you want to create multiple stops at once as it is more efficient and will produce better geocoding results.

post/plans/{planId}/stops:liveCreate

Request

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

pendingboolean required

Changes

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