ark_upsert_load_vendor_expense

ark.upsert_load_vendor_expense

Create or update one Vendor Expense on a visible ARK load, optionally adding or changing the linked customer rebill charge.

Availability: Expanded preview
Scopes: loads:readloads:writebilling:write
ARK permissions: canViewLoadscanViewBillingcanEditLoadcanMakeAdjustments
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

loadIdstringrequired

Visible ARK load ID.

format: uuid

idstring | null

Existing Vendor Expense ID when updating.

format: uuid

dispatchIdstring | null

Optional dispatch ID when the expense is tied to a specific carrier leg.

format: uuid

categorystringrequired

one of: Lumper, Insurance, Customs / Duties, Customs Broker, Transload / Crossdock, Toll, Permit, Storage, Scale Ticket, Washout, Other

amountnumberrequired

vendorNamestringrequired

min length: 1; max length: 200

paymentMethodstringrequired

one of: Credit Card, Check, ACH, Cash, EFS / Comcheck, Wire, E-Transfer, Other

paidAtstring | null

Optional paid date or timestamp captured for the Vendor Expense.

referenceNumberstring | null

max length: 200

descriptionstring | null

max length: 5000

notesstring | null

max length: 5000

billCustomerboolean

When true, create or update the linked customer rebill charge.

default: false

customerChargeNamestring | null

max length: 200

customerChargeAmountnumber | null

The tool returns the canonical ark.upsert_load_vendor_expense 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.

ark_upsert_load_vendor_expense

Input

Result