MCP documentation | MCP docs for agents
ark_create_load
ark.create_load
Create an available ARK load with customer, team, equipment, route stops, references, and optional customer charges.
- Availability
- Core preview
- Scopes
loads:write- ARK permissions
canCreateLoad- Team visibility
- Required and enforced
- Approval policy
ask_before_write- ARK approval request
- Required before execution
- Idempotency
- Required for external execution
- Read-only
- No
- Destructive
- No
- External side effect
- No
- Rate limit
- OAuth MCP credential and organization budgets
Input
customerIdstringrequiredformat: uuid
teamIdstringrequiredformat: uuid
brokerIdstring | nullcustomerServiceRepIdstring | nulltemperaturenumber | nullinternalCommentsstringdefault: ""; max length: 5000
externalCommentsstringdefault: ""; max length: 5000
hotCommentsstringdefault: ""; max length: 5000
productstringdefault: ""; max length: 200
valuenumber | nulldescriptionstringdefault: ""; max length: 5000
sizestringdefault: ""; max length: 100
trailerstringrequiredmin length: 1; max length: 100
weightnumber | nullweightUnitstringone of: lbs, kg; default: "lbs"
lengthnumber | nullwidthnumber | nullheightnumber | nullbillOfLadingstringdefault: ""; max length: 100
numberOfPiecesinteger | nullpickupNumberstringdefault: ""; max length: 100
purchaseOrderNumberstringdefault: ""; max length: 100
hazmatbooleandefault: false
docHighbooleandefault: false
stackablebooleandefault: false
tsabooleandefault: false
teamDriverRequiredbooleandefault: false
milesnumber | nullcustomerCurrencystringone of: USD, CAD, MXN; default: "USD"
carrierCurrencystringone of: USD, CAD, MXN; default: "USD"
customerPayarray<object>default: []; max items: 100
stopsarray<object>requiredmin items: 2; max items: 50
Result
The tool returns the canonical ark.create_load 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.