ARK TMS

MCP documentation | MCP docs for agents

ark_create_spot_quote_customer_quote_and_hold_bid

ark.create_spot_quote_customer_quote_and_hold_bid

Create and send a customer quote from a visible pending carrier bid, then hold that bid pending the customer response.

Availability
Expanded preview
Scopes
loads:write
ARK permissions
canEditLoad
Team visibility
Required and enforced
Approval policy
ask_before_send
ARK approval request
Required before execution
Idempotency
Required for external execution
Read-only
No
Destructive
No
External side effect
Yes
Rate limit
OAuth MCP credential and organization budgets

Input

spotQuoteIdstringrequired

Visible spot quote ID.

format: uuid

bidIdstringrequired

Visible pending carrier bid to hold after creating the customer quote.

format: uuid

holdReasonstring

max length: 5000

customerIdstringrequired

Customer ID. Must match the visible spot quote customer.

format: uuid

pricenumberrequired

Customer quote price.

markupPercentnumber

min: 0; max: 100

fromBidIdstring | null

Carrier bid used to generate the customer quote.

format: uuid

etaModestring | null

one of: time_away, exact_time, null

etaHoursinteger | null

min: 0; max: 999

etaMinutesinteger | null

min: 0; max: 59

etaDatetimestring | null

format: date-time

etaTimezonestring | null

max length: 100

quoteVehicleTypestring | null

max length: 100

trailerLengthnumber | null
trailerWidthnumber | null
trailerHeightnumber | null
trailerDimensionsUnitstring | null

one of: feet, inches, null

Result

The tool returns the canonical ark.create_spot_quote_customer_quote_and_hold_bid operation result in structuredContent and mirrors the same JSON as text. Errors set isError: true and return a stable error code, message, and optional details.